search

solid / solidproject.org

Website for solidproject.org
https://solidproject.org
MIT License
152 stars 103 forks source link

A reader could not find the Solid Protocol Spec #909

Open timbl opened 4 months ago

timbl commented 4 months ago

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 commented 4 months ago

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

michielbdejong commented 3 weeks ago

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 commented 3 weeks ago

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