- From: Sandro Hawke <sandro@w3.org>
- Date: Mon, 16 Mar 2015 17:41:29 -0400
- To: Nandana Mihindukulasooriya <nmihindu@fi.upm.es>
- CC: Linked Data Platform WG <public-ldp-wg@w3.org>, "Alexander J. Lin" <ajlin@mit.edu>
- Message-ID: <55074E09.6040805@w3.org>
I asked a couple students I work with (who are new to LDP) to read over the primer. I got these comments from one. Hopefully they're helpful. [and sorry for those of you for whom this is a second copy of this email] -- Sandro Alexander J Lin <ajlin@mit.edu> writes: > > > I really like the organization of the primer; it's pretty clear, > logical, and straightforward. The top-level organization where a > general example is followed by the more specific bug tracker example > is nice, and the organization of each section by HTTP verbs is > likewise illuminating. > > > I'm a bit concerned that there might be too much detail in some > places. Some of the sections feel a bit heavy (like "LDP concepts in a > glance"), and some of the notes include information that is helpful > but may not be strictly necessary (like the note in 3.1). I'm not sure > if that would benefit or confuse the readers; I guess that depends on > who is reading it. > > > Also, the syntax switching thing is awesome. > > > The other things are mostly grammatical: > > > * > > Abstract: “the notion of an LDP resource, the LDP container,and how” > > * > > You might want to split the examples in the abstract off into a > second sentence > > * > > Status: “as anythingother than a work in progress” > > * > > The sentence in the introduction starting with “By naming real > world entities” is somewhat awkward > > * > > Are the links in the introduction supposed to go to the > bibliography and not the links in the bibliography? > > * > > Section 2.1: "In this example, it supports the[list], andPATCH > HTTP Verbs" > > * > > Section 2.3: “Refer to theresource to be created” > > * In the acknowledgements: “We wouldalso like to thank” > >
Received on Monday, 16 March 2015 21:41:34 UTC