--- a/paq/prov-aq.html Thu Jan 10 00:06:22 2013 +0000
+++ b/paq/prov-aq.html Thu Jan 10 15:43:59 2013 +0100
@@ -207,32 +207,36 @@
resources on the Web. We describe both simple access mechanisms for
locating provenance descriptions associated with web pages or resources, and
provenance query services for more complex deployments. This is
-part of the larger W3C Prov provenance framework.
+part of the larger W3C PROV provenance family of documents.
+
+<p>The <a href="http://www.w3.org/TR/2012/WD-prov-overview-20121211/">PROV Document Overview</a> describes the overall state of PROV, and should be read before other PROV documents.</p>
+
</section>
- <section id="sotd">
- This document is part of a set of specifications produced by the W3C provenance working group to define interoperable interchange of provenance in heterogeneous environments such as the Web. It describes the use of existing web mechanisms for discovery and retrieval of provenance descriptions.
-
-
-<h4>PROV Family of Specifications</h4>
-This document is part of the PROV family of specifications, a set of specifications defining various aspects that are necessary to achieve the vision of inter-operable
-interchange of provenance in heterogeneous environments such as the Web. The specifications are:
+ <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:
<ul>
-<li> <a href="http://www.w3.org/TR/prov-dm/">PROV-DM</a>, the PROV data model for provenance [[PROV-DM]];</li>
-<li> <a href="http://www.w3.org/TR/prov-constraints/">PROV-CONSTRAINTS</a>, a set of constraints applying to the PROV data model [[PROV-CONSTRAINTS]];</li>
-<li> <a href="http://www.w3.org/TR/prov-n/">PROV-N</a>, a notation for provenance aimed at human consumption [[PROV-N]];</li>
-<li> <a href="http://www.w3.org/TR/prov-o/">PROV-O</a>, the PROV ontology, an OWL2 ontology allowing the mapping of PROV to RDF [[PROV-O]];</li>
-<li> <a href="http://www.w3.org/TR/prov-aq/">PROV-AQ</a>, the mechanisms for accessing and querying provenance (this document); </li>
-<li> <a href="http://www.w3.org/TR/prov-primer/">PROV-PRIMER</a>, a primer for the PROV data model [[PROV-PRIMER]].</li>
+<li> <a href="http://www.w3.org/TR/2012/WD-prov-overview-20121211/">PROV-OVERVIEW</a> (To be published as Note), an overview of the PROV family of documents [[PROV-OVERVIEW]];</li>
+<li> <a href="http://www.w3.org/TR/2012/WD-prov-primer-20121211/">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/2012/CR-prov-o-20121211/">PROV-O</a> (Candidate 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/2012/CR-prov-dm-20121211/">PROV-DM</a> (Candidate Recommendation), the PROV data model for provenance (this document);</li>
+<li> <a href="http://www.w3.org/TR/2012/CR-prov-n-20121211/">PROV-N</a> (Candidate Recommendation), a notation for provenance aimed at human consumption [[!PROV-N]];</li>
+<li> <a href="http://www.w3.org/TR/2012/CR-prov-constraints-20121211/">PROV-CONSTRAINTS</a> (Candidate Recommendation), a set of constraints applying to the PROV data model [[!PROV-CONSTRAINTS]];</li>
+<li> <a href="http://www.w3.org/TR/2012/WD-prov-aq-20120619/">PROV-AQ</a> (To be published as Note), the mechanisms for accessing and querying provenance (this document); </li>
+<li> <a href="http://www.w3.org/TR/2012/WD-prov-xml-20121211/">PROV-XML</a> (To be published as Note), an XML schema for the PROV data model [[PROV-XML]].</li>
+
</ul>
-<h4>How to read the PROV Family of Specifications</h4>
+<h4>How to read the PROV Family of Documents</h4>
<ul>
-<li>The primer is the entry point to PROV offering a pedagogical presentation of the provenance model.</li>
-<li>The Linked Data and Semantic Web community should focus on PROV-O defining PROV classes and properties specified in an OWL-RL ontology. For further details, PROV-DM and PROV-DM-CONSTRAINTS specify the constraints applicable to the data model, and its interpretation. PROV-SEM provides a mathematical semantics.</li>
-<li>The XML community should focus on PROV-XML defining an XML schema for PROV-DM. Further details can also be found in PROV-DM, PROV-DM-CONSTRAINTS, and PROV-SEM.</li>
-<li>Developers seeking to retrieve or publish provenance should focus of PROV-AQ.</li>
+<li>[[PROV-OVERVIEW]] overviews the PROV family of documents. </li>
+<li>The primer [[PROV-PRIMER]] is the entry point to PROV offering an introduction to the provenance model.</li>
+<li>The Linked Data and Semantic Web community should focus on [[!PROV-O]] defining PROV classes and properties specified in an OWL2 ontology. For further details, PROV-DM and [[!PROV-CONSTRAINTS]] specify the constraints applicable to the data model, and its interpretation. </li>
+<li>The XML community should focus on [[PROV-XML]] defining an XML schema for PROV. Further details can also be found in PROV-DM and [[!PROV-CONSTRAINTS]].</li>
+<li>Developers seeking to retrieve or publish provenance should focus on [[PROV-AQ]].</li>
<li>Readers seeking to implement other PROV serializations
-should focus on PROV-DM and PROV-DM-CONSTRAINTS. PROV-O, PROV-N, PROV-XML offer examples of mapping to RDF, text, and XML, respectively.</li>
+should focus on PROV-DM and [[!PROV-CONSTRAINTS]]. [[!PROV-O]], [[!PROV-N]], and [[PROV-XML]] offer examples of mapping to RDF, text, and XML, respectively.</li>
</ul>
<h4>Second Public Working Draft</h4>
<p>
@@ -246,7 +250,7 @@
<section>
<h2>Introduction</h2>
<p>
- The Provenance Data Model [[PROV-DM]], Provenance Ontology [[PROV-O]] and related specifications define how to represent provenance in the World Wide Web.
+ The Provenance Data Model [[PROV-DM]], Provenance Ontology [[PROV-O]] and related specifications (see the [[PROV-OVERVIEW]]) define how to represent provenance in the World Wide Web.
</p>
<p>
This note describes how standard web protocols may be used to locate, retrieve and query provenance descriptions:
@@ -339,8 +343,8 @@
</tr>
<tr style="vertical-align: top;">
<td><a class="internalDFN">Target-URI</a></td>
- <td>Any resource for which provenance is provided. This is an <a href="http://www.w3.org/TR/prov-dm/#term-entity" class="externalRef">Entity</a> in the sense described by [[PROV-DM]].</td>
- <td>If the URI is dereferencable, it should return a representation or description of entity for which provenance is provided.</td>
+ <td>Any resource for which provenance is provided.</td>
+ <td>If the URI is dereferencable, it should return a representation or description of the resource for which provenance is provided.</td>
</tr>
<tr style="vertical-align: top;">
<td><a class="internalDFN">Provenance-URI</a></td>
@@ -420,7 +424,7 @@
The consumer of a provenance description will generally need to isolate information about some specific target resource or resources. These may be <a class="internalDFN">constrained resource</a>s identified by separate target-URIs than the original resource. In such circumstances, a provenance consumer will need to know the target-URI used by a provenance description.
</p>
<p>
- We consider here mechanisms for a provider to indicate a <a class="internalDFN">provenance-URI</a> or <a class="internalDFN">Service-URI</a> along with a <a class="internalDFN">target-URI</a>.
+ We consider here mechanisms for a provider to indicate a <a class="internalDFN">provenance-URI</a> or <a class="internalDFN">service-URI</a> along with a <a class="internalDFN">target-URI</a>.
Three mechanisms are described:
</p>
<ul>
@@ -589,7 +593,7 @@
Property <code>prov:hasQueryService</code> specifies a <a class="internalDFN">service-URI</a> associated with the RDF document for accessing provenance descriptions. This property corresponds to a <code>hasQueryService</code> link relation used with an HTTP <code>Link</code> header field, or HTML <code><link></code> element.
</p>
<pre class="example code">
- @prefix prov: <http://www.w3.org/ns/prov#>
+ @prefix prov: <http://www.w3.org/ns/prov#>.
<> dcterms:title "Welcome to example.com" ;
prov:hasAnchor <http://example.com/data/resource.rdf> ;
@@ -647,7 +651,7 @@
</p>
<section>
- <h2>Direct HTTP query service</h2>
+ <h2>Direct HTTP query service description</h2>
<p>A direct HTTP query service is described by an RDF resource of type <code>prov:DirectQueryService</code></p>
<p>It allows for accessing provenance about a specified <a class="internalDFN">target-URI</a>. The query URI to use is described by a URI Template [[URI-template]] (level 2 or above) in which which the variable <cite><code>uri</code></cite> stands for the target-URI; e.g.</p>
<pre class="pattern">
@@ -679,12 +683,12 @@
</section>
<section>
- <h2>SPARQL query service</h2>
+ <h2>SPARQL query service description</h2>
<p>
A SPARQL query service is described by an RDF resource of type <code>sd:Service</code> [[SPARQL-SD]].
</p>
<p>
- It allows for accessing provenance information using a SPARQL query, which may be constructed to retrieve provenance for a particular entity, or for multiple entities. The query may be formulated using the PROVC-O vocabulary terms [[PROV-O]], and others supported by the SPARQL endpoint as appropriate.
+ It allows for accessing provenance information using a SPARQL query, which may be constructed to retrieve provenance for a particular resource, or for multiple resources. The query may be formulated using the PROV-O vocabulary terms [[PROV-O]], and others supported by the SPARQL endpoint as appropriate.
</p>
<p>
The SPARQL query service description is constructed as defined by <cite>SPARQL 1.1 Service Description</cite> [[SPARQL-SD]]; e.g.