Re: Comments on Primer

Hi Sandro/Alexander,

Thank you very much for the feedback and it's really helpful! We will fix
the issues highlighted.

Roger and I will discuss whether we can make the "LDP concepts in a glance"
less heavy and what to do with the note. Once we have an agreement, we'll
let the WG know.

Best Regards,
Nandana



On Mon, Mar 16, 2015 at 10:34 PM, Sandro Hawke <sandro@hawke.org> wrote:

>  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.
>
>         -- Sandro
>
> Alexander J Lin <ajlin@mit.edu> <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 anything other 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], and PATCH HTTP
>    Verbs"
>
>
>    -
>
>    Section 2.3: “Refer to the resource to be created”
>
>
>    - In the acknowledgements: “We would also like to thank”
>
>
>
>
>
>