solidproject.org icon indicating copy to clipboard operation
solidproject.org copied to clipboard

A reader could not find the Solid Protocol Spec

Open timbl opened this issue 1 year ago • 4 comments

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 avatar Jul 31 '24 11:07 timbl

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

timbl avatar Jul 31 '24 11:07 timbl

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 avatar Nov 08 '24 09:11 michielbdejong

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

michielbdejong avatar Nov 08 '24 09:11 michielbdejong

+1

I got to https://solidproject.org/about and was disappointed there isn't a link there.

I found the source for this page and... there is an attempt to link, but neither Firefox nor Chrome render this as a clickable link.

I would send a pull request to change it to something simple and working (ie. <a href="https://solidproject.org/TR/">specification</a>) but seeing the source makes me think this is not how this website wants to do things.

At least the for developers uses something that works...

DerSaidin avatar Jan 19 '25 23:01 DerSaidin