Re: Typos, etc., in WebID document

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

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
> >
>
>