Added section with table of URIs and what they dereference to (ISSUE 424)
authorGraham Klyne
Tue, 20 Nov 2012 11:36:30 +0000
changeset 4835 2f1a8ca558a8
parent 4834 d2acceb63c0b
child 4836 44586518f842
child 4837 4023ef1fee3d
Added section with table of URIs and what they dereference to (ISSUE 424)
paq/prov-aq.html
--- a/paq/prov-aq.html	Tue Nov 20 10:37:47 2012 +0000
+++ b/paq/prov-aq.html	Tue Nov 20 11:36:30 2012 +0000
@@ -13,7 +13,9 @@
     <script src="js/respec.js" class="remove"></script>
     <script src="file:///usr/workspace/w3c-provenance/prov/paq/js/respec.js" class="remove"></script>
 -->
+    <!-- Include bibliography file defined for PROV-DM: -->
     <script src="../model/provbib.js" class="remove"></script>
+    <!-- Define bibliography specific for PROV-AQ: @@TODO merge all additional bibliographies for PROV documents? -->
     <script class='remove'>
       var addExtraReferences = function() {
           for (var k in extraReferences)
@@ -300,7 +302,38 @@
         <p>
           Provenance information is not of itself guaranteed to be authoritative or correct. Trust in provenance information must be determined separately from trust in the original resource. Just as in the web at large, it is a user's responsibility to determine an appropriate level of trust in any other resource; e.g. based on the domain that serves it, or an associated digital signature. (See also <a href="#security-considerations" class="sectionRef"></a>.)
         </p>
+      </section>
 
+
+      <section>
+        <h2>URI types and dereferencing</h2>
+        <p>
+          A number of resource types are described above in <a href="#concepts" class="sectionRef"></a>.  The table below summarizes what these various URIs are intended to denote, and the kind of information that should be returned if they are dereferenced:
+        </p>
+        <table>
+          <tr>
+            <th></th>
+            <th>Denotes</th>
+            <th>Dereferences to</th>
+          </tr>
+          <tr style="vertical-align: top;">
+            <td><a class="internalDFN">Target-URI</a></td>
+            <td>Any resource for which provenance information is provided.  This is an <cite>entity</cite> in the sense described by [[PROV-DM]] (<a href="http://www.w3.org/TR/prov-dm/#term-entity" class="externalRef">Entity</a>).</td>
+            <td>If the URI is dereferencable, it should return a representation or description of entity for which provenance information is provided.</td>
+          </tr>
+          <tr style="vertical-align: top;">
+            <td><a class="internalDFN">Provenance-URI</a></td>
+            <td>A provenance description in the sense described by [[PROV-DM]] (<a href="http://www.w3.org/TR/prov-dm/#section-prov-overview" class="externalRef">PROV Overview</a>).</td>
+            <td>Provenance information in any of the defined formats selectable via content negotiation.</td>
+          </tr>
+          <tr style="vertical-align: top;">
+            <td><a class="internalDFN">Service-URI</a></td>
+            <td>A provenance service (i.e. a resource of type <code>prov:ProvenanceService</code>).  This is the initial URI used when accessing a provenance service; following REST API style [[REST-APIs]], actual URIs for accessing provenance information are obtained via the provenance service description.</td>
+            <td>A provenance service description per <a href="#provenance-service-description" class="sectionRef"></a>.  Alternative formats may be offered via HTTP content negotiation.</td>
+          </tr>
+        </table>
+        <p>
+        </p>
       </section>
 
     </section>
@@ -812,28 +845,28 @@
           <tr>
             <th>Name</th><th>Description</th><th>Definition ref</th>
           </tr>
-          <tr>
+          <tr style="vertical-align: top;">
             <td>ProvenanceService</td>
             <td>Class for a provenance service. Mainly for use in RDF provenance service descriptions, to facilitate discover..</td>
             <td><a href="#provenance-service-description" class="sectionRef"></a></td>
           </tr>
-          <tr>
+          <tr style="vertical-align: top;">
             <td>hasAnchor</td>
             <td>Indicates a <a class="internalDFN">target-URI</a>target-URI for a potentially dynamic resource instance</td>
             <td><a href="#resource-represented-as-html" class="sectionRef"></a></td>
           </tr>
-          <tr>
+          <tr style="vertical-align: top;">
             <td>hasProvenance</td>
             <td>Indicates a <a class="internalDFN">provenance-URI</a> for a resource;  the resource identified by this property provides provenance information about its subject or anchor resource.
             </td>
             <td><a href="#resource-accessed-by-http" class="sectionRef"></a>, <a href="#resource-represented-as-html" class="sectionRef"></a></td>
           </tr>
-          <tr>
+          <tr style="vertical-align: top;">
             <td>hasProvenanceService</td>
             <td>Indicates a <a class="internalDFN">provenance service</a> that can provide provenance information about its sibject or anchowresource.</td>
             <td><a href="#specifying-provenance-services" class="sectionRef"></a></td>
           </tr>
-          <tr>
+          <tr style="vertical-align: top;">
             <td>provenanceUriTemplate</td>
             <td>Relates a provenance service to a URI template string for constructing provenance-URIs</td>
             <td><a href="#provenance-service-description" class="sectionRef"></a></td>