Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
anderspitman opened this issue Dec 1, 2023 · 1 comment
Open
Labels

Comments

@anderspitman
Copy link

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

@raucao raucao added the docs label Dec 2, 2023
@raucao
Copy link
Member

raucao commented Dec 2, 2023

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Development

No branches or pull requests

2 participants