search

w3c / WebID

https://www.w3.org/groups/cg/webid
MIT License
14 stars 7 forks source link

fix: addresses David Booth's issues with diagram #68

Closed jacoscaz closed 3 months ago

jacoscaz commented 5 months ago

This PR is an attempt at addressing issues described in #11 and initially reported by David Booth in his message to the list dating back to 2021.

In the interest of clarity, I've intentionally decoupled the overview of the relationships between a WebID, the corresponding WebID Profile Document and the Agent from the real-life example referencing TimBL's WebID.

Setting the deadline for review in two weeks, on 2024-04-01.

Do not bother reviewing the spec/identity/index.html as that's automatically updated by our current CI setup based on the contents of spec/identity/index.bs. We'll sort this out in a separate issue / PR.

Links to the rendered files:

jacoscaz commented 5 months ago

Thank you @TallTed for reviewing!

TallTed commented 5 months ago

Something odd in the .bs to .html process inserted a space before a period. That process should be fixed.

TallTed commented 5 months ago

I am somewhat concerned about replacing the original diagram with this significantly reduced diagram, without having the alternatives visible side-by-side.

The original is directly linked here, but I was not able to make it display live on GitHub.

The original was trying (in part) to explain (without naming) HTTPRange-14 (also see its full Wikipedia entry), and so tried to diagram the connections between a 4Dspace human (TimBL, illustrated in the diagram as a photograph which was meant to represent the human world, not meant to be interpreted as that photograph itself), the identifier/named/denoter of that human (his WebID URI, http://www.w3.org/People/Berners-Lee/card#i [note: #i]), the identifier of the representational/profile/description document (now to be called his WebID Document, identified/denoted/named by a URL, http://www.w3.org/People/Berners-Lee/card [note: no #i]).