updates to address daniel and james comments
authorPaul Groth <p.t.groth@vu.nl>
Wed, 17 Apr 2013 19:38:06 +0200
changeset 6202 b723d16dd1a1
parent 6201 5cfb0d9fe43e
child 6203 df154d539caa
updates to address daniel and james comments
overview/prov-family.pdf
overview/prov-family.png
overview/prov-family.pptx
overview/prov-overview.html
Binary file overview/prov-family.pdf has changed
Binary file overview/prov-family.png has changed
Binary file overview/prov-family.pptx has changed
--- a/overview/prov-overview.html	Wed Apr 17 17:25:35 2013 +0200
+++ b/overview/prov-overview.html	Wed Apr 17 19:38:06 2013 +0200
@@ -400,16 +400,16 @@
 <li> <a href="http://www.w3.org/TR/2013/NOTE-prov-xml-20130430/">PROV-XML</a> (Note),  an XML schema for the PROV data model [[PROV-XML]];</li>
 <li> <a href="http://www.w3.org/TR/2013/NOTE-prov-aq-20130430/">PROV-AQ</a> (Note), mechanisms for accessing and querying provenance [[PROV-AQ]]; </li>
 <li> <a href="http://www.w3.org/TR/2013/NOTE-prov-dictionary-20130430/">PROV-DICTIONARY</a> (Note) introduces a specific type of collection, consisting of key-entity pairs [[PROV-DICTIONARY]];</li>
-<li> <a href="http://www.w3.org/TR/2013/NOTE-prov-dc-20130430/">PROV-DC</a> (Note) provides a mapping between PROV-O and Dublic Core Terms [[PROV-DC]];</li>
+<li> <a href="http://www.w3.org/TR/2013/NOTE-prov-dc-20130430/">PROV-DC</a> (Note) provides a mapping between PROV-O and Dublin Core Terms [[PROV-DC]];</li>
 <li> <a href="http://www.w3.org/TR/2013/NOTE-prov-sem-20130430/">PROV-SEM</a> (Note), a declarative specification in terms of first-order logic of the PROV data model [[PROV-SEM]];</li>
-<li> <a href="http://www.w3.org/TR/2013/NOTE-prov-links-20130430/">PROV-LINKS</a> (Note) introduces a mechanism to link across bundles . [[PROV-LINKS]]</li>
+<li> <a href="http://www.w3.org/TR/2013/NOTE-prov-links-20130430/">PROV-LINKS</a> (Note) introduces a mechanism to link across bundles [[PROV-LINKS]].</li>
 </ul>
 
 <h4>Implementations Encouraged</h4>
 <p>
 The Provenance Working Group encourages implementation of the specifications overviewed in this document. 
 Although work on this document by the Provenance Working Group is complete, 
-errors may be recorded in the  <a href="http://www.w3.org/2011/prov/errata.html">errata</a> or and these may be addressed in future revisions. 
+errors may be recorded in the  <a href="http://www.w3.org/2011/prov/errata.html">errata</a> and these may be addressed in future revisions. 
 </p>
 
 <h4>Please Send Comments</h4>
@@ -422,15 +422,35 @@
 <a href="http://www.w3.org/TR/2013/REC-prov-dm-20130430/#dfn-provenance">Provenance</a> is information about entities, activities, and people involved in producing a piece of data or thing, which can be used
 to form assessments about its quality, reliability or trustworthiness. The goal of PROV is to enable the wide publication and interchange of provenance on the Web and other information systems. PROV enables one to represent and interchange provenance information using widely available formats such as RDF and XML. In addition, it provides definitions for accessing provenance information, validating it, and mapping to Dublin Core.  When referring to PROV, we are referring to the entire family of documents. 
 <p>
-The design of PROV stems from the recommendations of the Provenance Incubator Group ([[PROV-XG]]) which performed an extensive information gathering process including use case cataloging, requirements elicitation and a literature survey. From this process, <a href="http://www.w3.org/2005/Incubator/prov/XGR-prov-20101214/#Broad_Recommendations">8 broad recommendations were defined</a>. <a href="http://www.w3.org/2001/sw/wiki/PROV-FAQ#How_does_PROV_address_the_recommendations_of_the_Provenance_Incubator_Group">PROV supports seven of the eight recommendations.</a>  Recommendation #2 was out of scope for standardization of activity of the working group, but it is believed that it can be supported by PROV extensibility points.
-</p>
+The design of PROV stems from the recommendations of the Provenance Incubator Group ([[PROV-XG]]) which performed an extensive information gathering process including use case cataloging, requirements elicitation and a literature survey. From this process, <a href="http://www.w3.org/2005/Incubator/prov/XGR-prov-20101214/#Broad_Recommendations">8 broad recommendations were defined</a>. Summarizing, the report recommends that a provenance framework should support:
+<ol>
+<li> the core concepts of identifying an object, attributing the object to person or entity, and representing processing steps;
+<li>accessing provenance-related information expressed in other standards;</li>
+<li>accessing provenance;</li>
+<li>the provenance of provenance;</li>
+<li>reproducibility;</li>
+<li>versioning;
+<li>
+representing procedures;
+</li>
+<li> and representing derivation.
+</li>
+</ol>
+
+<a href="http://www.w3.org/2001/sw/wiki/PROV-FAQ#How_does_PROV_address_the_recommendations_of_the_Provenance_Incubator_Group">PROV supports all eight of the recommendations</a> either directly or through extensibility points.
 
 <p>
-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. 
+Figure 1 shows the organization of PROV and how the documents (roughly) depend on each other. The coloring scheme corresponds to the document roadmap below.
+</p>
+<p>
+ 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. These serializations are used by implementations to interchange provenance. To help developers and users express valid provenance, a set of constraints (PROV-Constraints) are defined, which can be used to implement provenance validators. This is complimented by a formal semantics (PROV-SEM). Finally, to further support the interchange of provenance, additional specifications are provided for protocols to locate and access provenance (PROV-AQ), connect bundles of provenance descriptions (PROV-Links), represent dictionary style collections (PROV-Dictionary) and define how to interoperate with the widely used Dublin Core vocabulary (PROV-DC). 
 </p>
 
-<div>
-<img alt="Organization of PROV" src="./prov-family.png">
+
+<div style="text-align: center; ">
+ <span class="figure" style="max-width: 70%; "><img alt="The Organization of PROV" src="./prov-family.png" style="max-width: 70%;">
+<br>
+  </span>
 </div>
 
 </section> 
@@ -438,42 +458,48 @@
 <section id="roadmap">
 <h2>Document Roadmap</h2>
 PROV consists of 12 documents (including this one). In order to use PROV, one need not be familiar with all of these documents. Indeed, PROV was specifically designed so that users and developers may get started quickly with basic usage and then incrementally progress to more advanced usage scenarios. To help navigate PROV, each document is broadly classified as being intended for a specific audience. 
-
+<p>
 <ol>
-<li> Users - this audience wants to understand PROV and use applications that support PROV.
-<li> Developers - this audience wants to develop or build applications that create and consume provenance using PROV. 
-<li> Advanced - this audience aims to create validators, new PROV serializations, or other advanced provenance-based systems.
+<li> <span style="background: #DFF">Users</span> - this audience wants to understand PROV and use applications that support PROV.</li>
+<li> <span style="background: #CDD">Developers</span> - this audience wants to develop or build applications that create and consume provenance using PROV. </li>
+<li> <span style="background: #FDD">Advanced</span> - this audience aims to create validators, new PROV serializations, or other advanced provenance-based systems.</li>
 </ol>
 
-In the table below, we also denote whether the document is a <a href="http://www.w3.org/2005/10/Process-20051014/tr#RecsW3C">W3C Recommendation</a> or a <a href="http://www.w3.org/2005/10/Process-20051014/tr#WGNote">Working Group Note.</a> 
+Figure 1 is also color coded according to this classification.
+</p>
+
+<p>
+In the table below and Figure 1, we denote whether the document is a <a href="http://www.w3.org/2005/10/Process-20051014/tr#RecsW3C">W3C Recommendation</a> or a <a href="http://www.w3.org/2005/10/Process-20051014/tr#WGNote">Working Group Note.</a> In Figure 1, bold bordered boxes signal a W3C Recommendation.
+</p>
+<p>
 
 <table class="open-data-table">
 <tr><th>Part</th><th>Audience</th><th>Type</th><th>Document</th></tr>
-<tr><td style="text-align: center;">1</td><td  style="background: #DFF">Users</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/WD-prov-primer-20130312/">PROV-PRIMER</a> is the entry point to PROV offering an introduction to the provenance data model. This is where you should start and for many may be the only document needed.</td></tr>
-<tr><td style="text-align: center;">2</td><td  style="background: #CDD">Developers</td><td>Rec</td><td><a href="http://www.w3.org/TR/2013/PR-prov-o-20130312/">PROV-O</a> defines a light-weight OWL2 ontology for the provenance data model. This is intended for the Linked Data and Semantic Web community. </td></tr>
-<tr><td style="text-align: center;">3</td><td  style="background: #CDD">Developers</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/WD-prov-xml-20130312/">PROV-XML</a> defines an XML schema for the provenance data model. This is intended for developers who need a native XML serialization of the PROV data model.</td></tr>
-<tr><td style = "text-align: center;">4</td><td  style="background: #FDD">Advanced</td><td>Rec</td><td><a href="http://www.w3.org/TR/2013/PR-prov-dm-20130312/">PROV-DM</a> defines a conceptual data model for provenance including UML diagrams. PROV-O, PROV-XML and PROV-N are serializations of this conceptual model.</td></tr>
-<tr><td style = "text-align: center;">5</td><td  style="background: #FDD">Advanced</td><td>Rec</td><td><a href="http://www.w3.org/TR/2013/PR-prov-n-20130312/">PROV-N</a> defines a human-readable notation for the provenance model. This is used to provide examples within the conceptual model as well as used in the definition of PROV-CONSTRAINTS. </td></tr>
-<tr><td style = "text-align: center;">6</td> <td  style="background: #FDD">Advanced</td><td>Rec</td><td> <a href="http://www.w3.org/TR/2013/PR-prov-constraints-20130312/">PROV-CONSTRAINTS</a> defines a set of constraints on the PROV data model that specifies a notion of valid provenance. It is specifically aimed at the implementors of validators. </td></tr>
-<tr><td style="text-align: center;">7</td><td  style="background: #CDD">Developers</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/WD-prov-aq-20130312/">PROV-AQ</a> defines how to use Web-based mechanisms to locate and retrieve provenance information. </td></tr>
-<tr><td style="text-align: center;">8</td><td  style="background: #CDD">Developers</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/WD-prov-dc-20130312/">PROV-DC</a>  defines a mapping between Dublin Core and PROV-O. </td></tr>
-<tr><td style="text-align: center;">9</td><td  style="background: #CDD">Developers</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/WD-prov-dc-20130312/">PROV-DICTIONARY</a>  defines constructs for expressing the provenance of dictionary style data structures. </td></tr>
-<tr><td style="text-align: center;">10</td><td  style="background: #FDD">Advanced</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/WD-prov-sem-20130312/">PROV-SEM</a> defines a declarative specification in terms of first-order logic of the PROV data model.</li></td></tr>
-<tr><td style = "text-align: center;">11</td><td  style="background: #FDD">Advanced</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/WD-prov-links-20130312/">PROV-LINKS</a>  defines extensions to PROV to enable linking provenance information across bundles of provenance description.</td></tr>
+<tr><td style="text-align: center;">1</td><td  style="background: #DFF">Users</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/NOTE-prov-primer-20130430/">PROV-PRIMER</a> is the entry point to PROV offering an introduction to the provenance data model. This is where you should start and for many may be the only document needed.</td></tr>
+<tr><td style="text-align: center;">2</td><td  style="background: #CDD">Developers</td><td>Rec</td><td><a href="http://www.w3.org/TR/2013/REC-prov-o-20130430/">PROV-O</a> defines a light-weight OWL2 ontology for the provenance data model. This is intended for the Linked Data and Semantic Web community. </td></tr>
+<tr><td style="text-align: center;">3</td><td  style="background: #CDD">Developers</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/NOTE-prov-xml-20130430/">PROV-XML</a> defines an XML schema for the provenance data model. This is intended for developers who need a native XML serialization of the PROV data model.</td></tr>
+<tr><td style = "text-align: center;">4</td><td  style="background: #FDD">Advanced</td><td>Rec</td><td><a href="http://www.w3.org/TR/2013/REC-prov-dm-20130430/">PROV-DM</a> defines a conceptual data model for provenance including UML diagrams. PROV-O, PROV-XML and PROV-N are serializations of this conceptual model.</td></tr>
+<tr><td style = "text-align: center;">5</td><td  style="background: #FDD">Advanced</td><td>Rec</td><td><a href="http://www.w3.org/TR/2013/REC-prov-n-20130430/">PROV-N</a> defines a human-readable notation for the provenance model. This is used to provide examples within the conceptual model as well as used in the definition of PROV-CONSTRAINTS. </td></tr>
+<tr><td style = "text-align: center;">6</td> <td  style="background: #FDD">Advanced</td><td>Rec</td><td> <a href="http://www.w3.org/TR/2013/REC-prov-constraints-20130430/">PROV-CONSTRAINTS</a> defines a set of constraints on the PROV data model that specifies a notion of valid provenance. It is specifically aimed at the implementors of validators. </td></tr>
+<tr><td style="text-align: center;">7</td><td  style="background: #CDD">Developers</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/NOTE-prov-aq-20130430/">PROV-AQ</a> defines how to use Web-based mechanisms to locate and retrieve provenance information. </td></tr>
+<tr><td style="text-align: center;">8</td><td  style="background: #CDD">Developers</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/NOTE-prov-dc-20130430/">PROV-DC</a>  defines a mapping between Dublin Core and PROV-O. </td></tr>
+<tr><td style="text-align: center;">9</td><td  style="background: #CDD">Developers</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/NOTE-prov-dictionary-20130430/">PROV-DICTIONARY</a>  defines constructs for expressing the provenance of dictionary style data structures. </td></tr>
+<tr><td style="text-align: center;">10</td><td  style="background: #FDD">Advanced</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/NOTE-prov-sem-20130430/">PROV-SEM</a> defines a declarative specification in terms of first-order logic of the PROV data model.</li></td></tr>
+<tr><td style = "text-align: center;">11</td><td  style="background: #FDD">Advanced</td><td>Note</td><td><a href="http://www.w3.org/TR/2013/NOTE-prov-links-20130430/">PROV-LINKS</a>  defines extensions to PROV to enable linking provenance information across bundles of provenance descriptions.</td></tr>
 
 </table>
-
+</p>
 </section>
 
 <section>
 <h2>Namespace</h2>
-All terms defined within PROV are defined within the namespace <a href="http://www.w3.org/ns/prov#">http://www.http://www.w3.org/ns/prov#</a>. The prefix convention that is used is <b>prov</b>. Thus, no matter which document you use the namespace will be the same. The decision was made to simplify the usage of PROV. 
+All terms defined within PROV are defined within the namespace <a href="http://www.w3.org/ns/prov#">http://www.w3.org/ns/prov#</a>. The prefix convention that is used is <b>prov</b>. Thus, no matter which document you use the namespace will be the same. The decision was made to simplify the usage of PROV. 
 </section>
 
 
 <section>
 <h2>Additional Information</h2>
-In addition, to these specifications, the <a href="http://www.w3.org/2001/sw/wiki/PROV-FAQ">PROV FAQ</a> page addresses common questions as well as sets PROV in a broader context. This page is continually updated. Working group members have also given several <a href="http://www.w3.org/2001/sw/wiki/PROV-Outreach">tutorials</a> about PROV including hands-on exercises, these may be a useful place to start. In addition, one can find a variety of blog posts and web pages on PROV - a short list can be found <a href="http://www.w3.org/2001/sw/wiki/PROV-Outreach">here</a>.
+In addition to these specifications, the <a href="http://www.w3.org/2001/sw/wiki/PROV-FAQ">PROV FAQ</a> page addresses common questions as well as sets PROV in a broader context. This page will continue to be updated after the publication of this Note and other PROV documents. Working group members have also given several <a href="http://www.w3.org/2001/sw/wiki/PROV-Outreach">tutorials</a> about PROV including hands-on exercises, which may be a useful place to start. In addition, one can find a variety of blog posts and web pages on PROV - a short list can be found <a href="http://www.w3.org/2001/sw/wiki/PROV-Outreach">here</a>.
 
 For a broader review of provenance that led to the creation of PROV, there are several reports produced by the <a href="http://www.w3.org/2005/Incubator/prov/wiki/W3C_Provenance_Incubator_Group_Wiki">W3C Provenance Incubator group</a>  including:
 
@@ -484,7 +510,7 @@
 </ol>
 
 
-Finally, the simplest way to use PROV is through one of the many applications that support it. Please see the group's <a href="http://www.w3.org/TR/2013/WD-prov-implementations-20130312/">implementation report</a> that highlights reported implementations of PROV.
+Finally, the simplest way to use PROV is through one of the many applications that support it. Please see the group's <a href="http://www.w3.org/TR/2013/NOTE-prov-implementations-20130430/">implementation report</a> that highlights reported implementations of PROV.
 
 
 </section>