Re: Typos, etc., in WebID document

We now have a github repo for the WebID specs.

https://github.com/w3c/WebID

PRs are welcome.

Henry

> On 31 Mar 2021, at 12:52, Henry Story <henry.story@gmail.com> wrote:
> 
> 
> 
>> 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
>>> 
>> 
>