Re: Typos, etc., in WebID document

> On 31 Mar 2021, at 12:28, Melvin Carvalho <melvincarvalho@gmail.com> wrote:
> 
> 
> 
> On Wed, 24 Mar 2021 at 17:46, Henry Story <henry.story@gmail.com> wrote:
> Thanks David for these detailed improvements!
> That is just what was needed to incite me to think about evolving the document.
> 
> Now that W3C has moved to github, I guess we need to find out if there is a github repo
> where all this data is stored, and if we can access it to evolve the document.
> 
> We've been flagging editorial improvements, bug fixes, and other changes since at least 2013, more in 2015, 2019, 2020 etc.
> 
> The truth is that no one knows how to make any changes, and we dont have anyone that can drive them forward

Is there a link to a list of these? Do you want to put this together?

I was away trying to build stuff, trying to get EU projects together, then
studying mathematics and category theory ;-)

I have received a grant for an EU project this year so I will have time to
do some cleanup.

https://nlnet.nl/project/SolidControl/

Hopefully we just have some simple things to do, as there is so much other work to
be done.

> 
> IMHO we need a new chair for this to happen
> 
> 
> Henry
> 
> 
> > On 24 Mar 2021, at 15:09, David Booth <david@dbooth.org> wrote:
> >
> > This is a nice, concise little write-up of a basic principle.  Thanks for doing it!
> >
> > I have one substantive comment.  At the beginning of section 4, I like the diagram, but I do not understand the "sense" arrow and do not see why it is needed at all.  AFAICT, there are *two* things being differentiated: the profile document versus TimBL (the person) -- not three.  So to my mind, the "sense" arrow only adds confusion.  Also, I do not understand the purpose of the stick-figure on the profile document.  There is no stick figure in the profile document, so I do not understand why the diagram shows one on it.  The diagram also shows a foaf:made link coming from the stick figure and pointing to the bottom of the profile card.  I don't understand what that is intended to mean, but TimBL's profile card does not even contain a foaf:made link, so that seems to be a mistake.
> >
> > Aside from that, I noticed several editorial issues that I thought you might like to correct:
> >
> > 1. The "Latest editor's draft" link goes to
> > https://dvcs.w3.org/hg/WebID/raw-file/tip/spec/identity-respec.html
> > which has a "This version" link that is 404:
> > http://www.w3.org/2005/Incubator/webid/spec/drafts/ED-webid-20121118
> >
> > 2. s/which/that/ in "A WebID is an HTTP URI which refers to an Agent"
> > See https://blog.apastyle.org/apastyle/2012/01/that-versus-which.html
> >
> > 3. Change "that any Social Network user is familiar with" to "that would be familiar to any Social Network user".
> >
> > 4. Change "to link together their profiles in a public" to "to link their profiles in a public".
> >
> > 5. s/resource/resources/ in "by allowing access to resource"
> >
> > 6. s/such that/such as that/ in "such that he/she is known"
> >
> > 7. Change "A Server is a machine contactable at a domain name or IP address that hosts a number of globally accessible Services." to
> > "A Server is a machine, contactable at a domain name or IP address, that hosts globally accessible Services."
> >
> > 8. s/given/particular/g in "A Service is an agent listening for requests at a given IP address on a given Server"
> >
> > 9. s/which/that/ in "A WebID is a URI with an HTTP or HTTPS scheme which denotes an Agent"
> >
> > 10. s/which/that/ in "A WebID Profile is an RDF document which uniquely describes"
> >
> > 11. s/Alice/Bob/g in "Therefore, two URIs are needed, one for Alice and one for the homepage or a RDF document describing Alice"
> >
> > 12. Change "Which one to use depends on the situation, both have advantages" to
> > "Which one to use depends on the situation.  Both have advantages"
> >
> > 13. The sentence beginning "The WebID Profile gives the sense of the WebID:" seems to be attempting to define the word "sense", because it puts that word in italics.  I don't think that is necessary or helpful. I think it would be more readily understandable just to write (with no italics): "The WebID Profile defines the meaning of the WebID:"
> >
> > 14. s/another document/other documents/ in "contain relations to another document depicting"
> >
> > 15. s/RDFa/RDFa,/ in "even if it is not marked up in RDFa"
> >
> > 16. s/as well/as well as/ in "may contain public as well personal"
> >
> > Thanks,
> > David
> >
>