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

A reader could not find the Solid Protocol Spec #909

Open
timbl opened this issue Jul 31, 2024 · 3 comments
Open

A reader could not find the Solid Protocol Spec #909

timbl opened this issue Jul 31, 2024 · 3 comments

Comments

@timbl
Copy link
Contributor

timbl commented Jul 31, 2024

Describe the bug
A clear and concise description of what the bug is.
See
https://www.schneier.com/blog/archives/2024/07/data-wallets-using-the-solid-protocol.html/#comment-439565

To Reproduce
Steps to reproduce the behavior:

  1. Go to '...'
  2. Click on '....'
  3. Scroll down to '....'
  4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Use of the word "specification" should be linked the github repo

@timbl
Copy link
Contributor Author

timbl commented Jul 31, 2024

Link to the spec from more than one place, but certaijly the Developer.
Maybe make it a top level menu item.

@TallTed TallTed changed the title A reders could not find the Solid Protocol Spec A reader could not find the Solid Protocol Spec Aug 1, 2024
@michielbdejong
Copy link
Contributor

I just came here to report this exact same issue!

It seems there is no link from any of the pages on https://solidproject.org to https://solidproject.org/TR/protocol.

Even though the 'About Solid' page says 'Solid is a specification', there is no hyperlink there, and it's pretty hard to get from there to the actual specification.

The shortest path I found was to click 'Community' on the top right, then 'Go to Community Group', then 'Solid Technical Reports', then work item 'Solid Protocol'.

Indeed, let's add a big "Read the spec" button on the 'For developers' page.

@michielbdejong
Copy link
Contributor

And actually even https://solidproject.org/specification does not link directly to https://solidproject.org/TR/protocol

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

No branches or pull requests

2 participants