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

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

Closed
wants to merge 7 commits into from
Closed

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

wants to merge 7 commits into from

Conversation

jacoscaz
Copy link
Collaborator

@jacoscaz jacoscaz commented Mar 18, 2024

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 jacoscaz linked an issue Mar 18, 2024 that may be closed by this pull request
@jacoscaz jacoscaz changed the title fix: addresses David Booth's issues with diagram (closes #11) fix: addresses David Booth's issues with diagram Mar 18, 2024
spec/identity/index.html Outdated Show resolved Hide resolved
@jacoscaz
Copy link
Collaborator Author

Thank you @TallTed for reviewing!

spec/identity/index.bs Outdated Show resolved Hide resolved
@TallTed
Copy link
Member

TallTed commented Mar 18, 2024

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

@TallTed
Copy link
Member

TallTed commented Mar 26, 2024

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]).

@jacoscaz jacoscaz closed this by deleting the head repository May 28, 2024
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

Successfully merging this pull request may close these issues.

Address David Booth's issue with diagram
2 participants