revisions to final version
authorPaul Groth <p.t.groth@vu.nl>
Tue, 09 Apr 2013 20:58:09 +0200
changeset 6113 79aa6132389f
parent 6112 efa6f33e97cd
child 6114 d3308ed33073
revisions to final version
overview/prov-overview.html
--- a/overview/prov-overview.html	Tue Apr 09 20:57:52 2013 +0200
+++ b/overview/prov-overview.html	Tue Apr 09 20:58:09 2013 +0200
@@ -298,12 +298,12 @@
               berjon.biblio[k] = extraReferences[k];
       };
       var extraReferences = {
-        
+          "PROV-XG" : "Yolanda Gil, James Cheney, Paul Groth, Olaf Hartig, Simon Miles, Luc Moreau, Paulo Pinherio da Silva. <a href='http://www.w3.org/2005/Incubator/prov/XGR-prov-20101214/'> Provenance XG Final Report.</a> December 2010.<a href='http://www.w3.org/2005/Incubator/prov/XGR-prov-20101214/'>http://www.w3.org/2005/Incubator/prov/XGR-prov-20101214/</a>",
       };
       
       var respecConfig = {
           // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
-          specStatus:           "WD-NOTE",
+          specStatus:           "WG-NOTE",
           
           // the specification's short name, as in http://www.w3.org/TR/short-name/
           shortName:            "prov-overview",
@@ -314,7 +314,7 @@
 
  
           // if you wish the publication date to be other than today, set this
-          publishDate:  "2013-03-12",
+          publishDate:  "2013-04-30",
  
           // if the specification's copyright date is a range of years, specify
           // the start date here:
@@ -322,7 +322,7 @@
  
           // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
           // and its maturity status
-          previousPublishDate:  "2012-12-11",
+          previousPublishDate:  "2014-03-12",
           previousMaturity:  "WD",
  
           // if there a publicly available Editor's Draft, this is the link
@@ -380,41 +380,51 @@
     <section id="abstract">
 <p>
 Provenance 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 PROV Family of Documents defines a model, corresponding serializations and other supporting defintions to enable the inter-operable interchange of provenance information in heterogeneous environments such as the Web. This document provides an overview this family of documents. 
+to form assessments about its quality, reliability or trustworthiness. The PROV Family of Documents defines a model, corresponding serializations and other supporting definitions to enable the inter-operable interchange of provenance information in heterogeneous environments such as the Web. This document provides an overview this family of documents. 
 
  </section> 
 
 <section id="sotd">
 
-
 <h4>PROV Family of Documents</h4>
 This document is part of the PROV family of documents, a set of documents defining various aspects that are necessary to achieve the vision of inter-operable
-interchange of provenance information in heterogeneous environments such as the Web.  These documents are listed below.  
+interchange of provenance information in heterogeneous environments such as the Web.  These documents are listed below. 
+
 <ul>
-<li> <a href="http://www.w3.org/TR/2013/WD-prov-overview-20130312/">PROV-OVERVIEW</a> (To be published as Note), an overview of the PROV family of documents (this document);</li>
-<li> <a href="http://www.w3.org/TR/2013/WD-prov-primer-20130312/">PROV-PRIMER</a> (To be published as Note), a primer for the PROV data model [[PROV-PRIMER]];</li>
-<li> <a href="http://www.w3.org/TR/2013/PR-prov-o-20130312/">PROV-O</a> (Proposed Recommendation), the PROV ontology, an OWL2 ontology allowing the mapping of PROV to RDF [[PROV-O]];</li>
-<li> <a href="http://www.w3.org/TR/2013/PR-prov-dm-20130312/">PROV-DM</a> (Proposed Recommendation), the PROV data model for provenance; [[PROV-DM]]</li>
-<li> <a href="http://www.w3.org/TR/2013/PR-prov-n-20130312/">PROV-N</a> (Proposed Recommendation), a notation for provenance aimed at human consumption [[PROV-N]];</li>
-<li> <a href="http://www.w3.org/TR/2013/PR-prov-constraints-20130312/">PROV-CONSTRAINTS</a> (Proposed Recommendation), a set of constraints applying to the PROV data model [[PROV-CONSTRAINTS]];</li>
-<li> <a href="http://www.w3.org/TR/2013/WD-prov-xml-20130312/">PROV-XML</a> (To be published as Note),  an XML schema for the PROV data model [[PROV-XML]];</li>
-<li> <a href="http://www.w3.org/TR/2013/WD-prov-aq-20130312/">PROV-AQ</a> (To be published as Note), the mechanisms for accessing and querying provenance [[PROV-AQ]]; </li>
-<li> <a href="http://www.w3.org/TR/2013/WD-prov-dictionary-20130312/">PROV-DICTIONARY</a> (To be published as Note) introduces a specific type of collection, consisting of key-entity pairs [[PROV-DICTIONARY]];</li>
-<li> <a href="http://www.w3.org/TR/2013/WD-prov-dc-20130312/">PROV-DC</a> (To be published as Note) provides a mapping between PROV and Dublic Core Terms [[PROV-DC]];</li>
-<li> <a href="http://www.w3.org/TR/2013/WD-prov-sem-20130312/">PROV-SEM</a> (To be published as 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/WD-prov-links-20130312/">PROV-LINKS</a> (To be published as Note) introduces a mechanism to link across bundles [[PROV-LINKS]].</li>
+<li> <a href="http://www.w3.org/TR/2013/NOTE-prov-overview-20130430/">PROV-OVERVIEW</a> (Note), an overview of the PROV family of documents (this document);</li>
+<li> <a href="http://www.w3.org/TR/2013/NOTE-prov-primer-20130430/">PROV-PRIMER</a> (Note), a primer for the PROV data model [[PROV-PRIMER]];</li>
+<li> <a href="http://www.w3.org/TR/2013/REC-prov-o-20130430/">PROV-O</a> (Recommendation), the PROV ontology, an OWL2 ontology allowing the mapping of the PROV data model to RDF [[PROV-O]];</li>
+<li> <a href="http://www.w3.org/TR/2013/REC-prov-dm-20130430/">PROV-DM</a> (Recommendation), the PROV data model for provenance [[PROV-DM]];</li>
+<li> <a href="http://www.w3.org/TR/2013/REC-prov-n-20130430/">PROV-N</a> (Recommendation), a notation for provenance aimed at human consumption [[PROV-N]];</li>
+<li> <a href="http://www.w3.org/TR/2013/REC-prov-constraints-20130430/">PROV-CONSTRAINTS</a> (Recommendation), a set of constraints applying to the PROV data model [[PROV-CONSTRAINTS]];</li>
+<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-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>
 </ul>
 
+<p>
+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. 
+</p>
+
+<h4>Please Send Comments</h4>
+
 </section>
 
 <section id="introduction"> 
       <h2>Introduction</h2> 
-This document provides a non-normative overview of the PROV Family of Documents and provides a roadmap to using these these documents.
+This document provides a non-normative overview of the PROV Family of Documents and provides a roadmap to using them.
 Provenance 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. 
+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 acquisition and 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>. PROV supports all 8 recommendations either through a complete definition or through extensibility points.
+</p>
 
 <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 what are used by implementations to interchange provenance. To help developers and users create valid provenance, a set of constraints are defined, which can be used to create provenance validators. Finally, to further support the interchange of provenance, additional definitions 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, which defines a common vocabulary used to describe provenance. This is instantiated by various serializations. These serializations are what are used by implementations to interchange provenance. To help developers and users create valid provenance, a set of constraints are defined, which can be used to create 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. 
 </p>
 
 <div>
@@ -425,7 +435,7 @@
 
 <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. 
+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. 
 
 <ol>
 <li> Users - this audience wants to understand PROV and use applications that support PROV.
@@ -433,29 +443,35 @@
 <li> Advanced - this audience aims to create validators, new PROV serializations, or other advanced provenance systems.
 </ol>
 
-In the table below, we also denote the track that each document on whether it is intended to be a W3C Recommendation or a Working Group Note. 
+In the table below, we also denote whether the document is a W3C Recommendation or a Working Group Note. 
 
 <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 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 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 model. This is intended for developers who need a native XML serialization of PROV</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/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 and PROV-XML 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 provenance. This is used to define the conceptual model as well as 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 constraints that define a notion of valid provenance. It is specifically aimed at the implementors of validators. </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 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. </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 containers for provenance</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 containers for provenance.</td></tr>
 
 </table>
 
 </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. 
+</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/2011/prov/wiki/OutreachInformation">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/2011/prov/wiki/OutreachInformation">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 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>.
 
 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:
 
@@ -465,6 +481,7 @@
 <li> <a href="http://www.w3.org/2005/Incubator/prov/XGR-prov-20101214/#State_of_the_art_and_technology_gaps">State of the Art Report</a></li>
 </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.
 
 
@@ -481,7 +498,21 @@
 
 
 
-<section class="appendix"> 
+<section class="appendix">  
+<h2>Change Log</h2>
+<section>
+      <h3>Change Log Since WD Working Draft 12 March 2013</h3> 
+<ul>
+<li> Changed the status of this document section.
+<li> Changed all URLs to  PROV documents.
+<li> Updated the figure to move prov-n outside of prov-dm and to put prov-dc on top of prov-o.
+<li>  Added section on namespaces.
+<li> Added a paragraph discussing the broad recommendations from the incubator group.
+<li> Editorial pass following reviews.
+</ul>
+</section>
+
+<section>
       <h2>Acknowledgements</h2> 
       <p>