PROV-Overview review

Hi Paul, Luc.
Below is my review of PROV Overview.
In general it's just a couple of editorial changes and a few typos.
Nice work!
Thanks,
Daniel

Document reviewed (latest working draft):
https://dvcs.w3.org/hg/prov/raw-file/default/overview/prov-overview.html
On 04-16-2013.

PROV family of Documents
    Dublic Core -> Dublin Core.
    bundles . [PROV-LINKS] -> bundles. [PROV-LINKS]

Introduction
    I think the figure should have a title. Something like: Figure 1:
organization of PROV.

    The different modules could be mentioned when explaining the figure.
That would make it easier to follow.
    Suggestion:
    "Below is the organization of PROV. At its core is a conceptual data
model, which defines a common vocabulary
    used to describe provenance. This is instantiated by various
serializations. These serializations are used by
    implementations to interchange provenance. To help developers and users
express valid provenance, a set of
    constraints are defined, which can be used to implement provenance
validators. Finally, to further support the
    interchange of provenance, additional specifications are provided for
protocols to locate and access provenance,
    connect sets of provenance descriptions, and define how to interoperate
with the widely used Dublin Core vocabulary."
    -->
    "Below is the organization of PROV. At its core is a conceptual data
model (PROV-DM), which defines a common vocabulary
    used to describe provenance. This is instantiated by various
serializations (PROV-O, PROV-N, PROV-XML, etc). These serializations are
used by
    implementations to interchange provenance. To help developers and users
express valid provenance, a set of
    constraints are defined (PROV-CONSTRAINTS), which can be used to
implement provenance validators. Finally, to further support the
    interchange of provenance, additional specifications are provided for
protocols to locate and access provenance (PROV-AQ),
    connect sets of provenance descriptions (PROV-LINKS), and define how to
interoperate with the widely used Dublin Core vocabulary (PROV-DC)."

    Note that no reference to prov-dictionary or prov sem can be found in
the description.

Document Roadmap
    Typo in Table, row 11: "...across bundles of provenance description."
--> "across bundles of provenance descriptions."

Namespace
    "...within the namespace http://www.http://www.w3.org/ns/prov#" ->
namespace should be http://www.w3.org/ns/prov#

Additional information
    All links point to the release of April 30 except for the PROV
implementation report:
http://www.w3.org/TR/2013/WD-prov-implementations-20130312/

Acknowledgements: Could you please change my institution to Daniel Garijo
(Ontology Engineering Group, Universidad Politécnica de Madrid)?

Received on Tuesday, 16 April 2013 22:08:39 UTC