Re: some observations about the front matter

Hi Annette,

Thanks for your review. Please, find my comments inline.

Introduction
> --
> First paragraph, some examples have no clear relationship to the web;
> "this phenomenon" has no clear antecedent.
> Needs a careful native-speaker edit.
>

Could you please be more specific about the examples that have no clear
relationship to the Web?

Audience
> --
> Remove "such as CSV, JSON and RDF." They are too specific; don't use
> examples here.
>

Why do you think that we shouldn't use examples ? I'm ok with removing the
examples, but I'd like to understand the reason for this.


>
> Context
> --
> The word "mainly" needs to be removed here: "The DWBP document is mainly
> interested on the Identification principle that says that URIs should be
> used to identify resources." "Mainly" means that it is more important than
> other considerations, which isn't true and probably isn't what was meant.
>

Ok! We  wanted to highlight the Identification principle, but maybe this is
not a good way to say this.


> I disagree with the statement that "multiple Dataset Access mechanisms
> should be available."
>

Could you please explain why do you disagree with this statement? Maybe
this is also a rewriting issue.


>
> The diagram is still confusing for me. I can't tell what it is trying to
> say. What is the relationship between the blue dataset and the green,
> yellow, and orange rectangles supposed to be showing? Why does a blue box
> refer to a dataset and then to distributions? Why is the grouping within
> blue boxes different after the arrow? What does the dotted line represent?
> What does the arrow represent?
>
> This section wanders between discussion of basic definitions and an
> incomplete enumeration of the best practices themselves. It needs to be
> rewritten so that it has a clear purpose and adheres to it.
>

Eric is helping us to rewrite the text and to make changes on the diagram
to make it more clear. As soon as we have a new proposal, we're gonna make
it available to have feedback from the group,


>
> Basic Example
> --
> It should be about more modes of transit than just buses. We have some
> examples that use multiple modes.
>


I'm not sure if it's better to change the Basic Example or to change the
examples that consider multiple modes. I'm affraid of creating big
expectations on the public if we mention multiple modes in example
description, but just few BP examples really consider this aspect.


Thanks!
Bernadette


>
> --
> Annette Greiner
> NERSC Data and Analytics Services
> Lawrence Berkeley National Laboratory
>
>
>


-- 
Bernadette Farias Lóscio
Centro de Informática
Universidade Federal de Pernambuco - UFPE, Brazil
----------------------------------------------------------------------------