search

remotestorage / remotestorage.js

⬡ JavaScript client library for integrating remoteStorage in apps
https://remotestoragejs.readthedocs.io
MIT License
2.3k stars 141 forks source link

http://remotestorage.io/spec/folder-description is a dead link #1301

Open anderspitman opened 7 months ago

anderspitman commented 7 months ago

I'm looking for the JSON-LD context description for RS, but the link 404s

raucao commented 7 months ago

Thanks for bringing it up again! I vaguely remember having had an issue for it somewhere in the past, but I couldn't find it just now. We also managed to bury the link to the actual spec quite efficiently, by not including it on the new Protocol page, which replaced the old wiki page.

The format for the listings is defined here: https://datatracker.ietf.org/doc/html/draft-dejong-remotestorage-21#section-4

Regarding actual content at the context URL, we moved the website to GitHub pages a while back, so it's actually fairly easy for anyone to create a PR for this now!

@anderspitman Do you have a specific format in mind for the content you would want to find there? @michielbdejong Did you have something in mind before? Or @remotestorage/core, does someone remember what we discussed to publish there in the past?

I think the nicest would be to deliver a JSON Schema document when requesting JSON, and human-readable content when not. But I don't think we can do content negotiation on GitHub pages.

However, if we really want that, we could put a reverse proxy in front of the whole website, and proxy anything that's not handled by it (like e.g. the context URLs) to GH Pages. The data modules also create similar URLs by default (when not adding one's own), so it would be pretty nice to have those resolve as well.