Changed link relations to URIs; removed IANA considerations section
authorGraham Klyne
Fri, 16 Nov 2012 16:01:49 +0000
changeset 4786 3144d9093733
parent 4785 77c849e3d67d
child 4787 5f35560288e7
Changed link relations to URIs; removed IANA considerations section
paq/prov-aq.html
--- a/paq/prov-aq.html	Sat Nov 10 19:03:26 2012 +0000
+++ b/paq/prov-aq.html	Fri Nov 16 16:01:49 2012 +0000
@@ -7,10 +7,10 @@
     <link rel="stylesheet" type="text/css" href="css/prov-aq.css" />
     <meta http-equiv='Content-Type' content='text/html;charset=utf-8'/>
 <!--  Use common W3C-hosted version of ReSpec.js:
--->
     <script src="http://dev.w3.org/2009/dap/ReSpec.js/js/respec.js" class="remove"></script>
+-->
+    <script src="js/respec.js" class="remove"></script>
 <!--  Use local version of ReSpec.js for debugging:
-    <script src="js/respec.js" class="remove"></script>
     <script src="file:///usr/workspace/w3c-provenance/prov/paq/js/respec.js" class="remove"></script>
 -->
     <script src="../model/provbib.js" class="remove"></script>
@@ -362,13 +362,14 @@
 
       <section>
         <h2>Resource accessed by HTTP</h2>
-        <p class="TODO">
-          @@TODO: Use URIs for link relations (?)
-        </p>
         <p>
           For a resource accessible using HTTP, provenance information may be indicated using an HTTP <code>Link</code> header field, as defined by <a href="http://tools.ietf.org/html/rfc5988">Web Linking (RFC 5988)</a> [[LINK-REL]].  The <code>Link</code> header field is included in the HTTP response to a GET or HEAD operation (other HTTP operations are not excluded, but are not considered here).
         </p>
-A <code>provenance</code> link relation type for referencing provenance information is registered according to the template in <a href="#iana-considerations" class="sectionRef"></a>, and may be used as shown:  <pre class="pattern">Link: <cite>provenance-URI</cite>; rel="provenance"; anchor="<cite>target-URI</cite>"</pre> When used in conjunction with an HTTP success response code (<code>2xx</code>), this HTTP header field indicates that <code><cite>provenance-URI</cite></code> is the URI of some provenance information associated with the requested resource and that the associated resource is identified within the referenced provenance information as <code><cite>target-URI</cite></code>. (See also <a href="#interpreting-provenance-information" class="sectionRef"></a>.)
+A <code>hasProvenance</code> link relation type for referencing provenance information may be used as shown:
+
+<pre class="pattern">Link: <cite>provenance-URI</cite>; rel="http://www.w3.org/ns/prov#hasProvenance"; anchor="<cite>target-URI</cite>"</pre>
+
+When used in conjunction with an HTTP success response code (<code>2xx</code>), this HTTP header field indicates that <code><cite>provenance-URI</cite></code> is the URI of some provenance information associated with the requested resource and that the associated resource is identified within the referenced provenance information as <code><cite>target-URI</cite></code>. (See also <a href="#interpreting-provenance-information" class="sectionRef"></a>.)
         <p>
         If no <code>anchor</code> parameter is provided then the <code><cite>target-URI</cite></code> is assumed to be the URI of the resource, used in the corresponding HTTP request.
         </p>
@@ -376,10 +377,10 @@
           At this time, the meaning of these links returned with other HTTP response codes is not defined: future revisions of this specification may define interpretations for these.
         </p>
         <p>
-          An HTTP response MAY include multiple <code>provenance</code> link header fields, indicating a number of different provenance resources that are known to the responding server, each providing provenance information about the accessed resource.
+          An HTTP response MAY include multiple <code>hasProvenance</code> link header fields, indicating a number of different provenance resources that are known to the responding server, each providing provenance information about the accessed resource.
         </p>
         <p>
-          The presence of a <code>provenance</code> link in an HTTP response does not preclude the possibility that other publishers may offer provenance information about the same resource.  In such cases, discovery of the additional provenance information must use other means (e.g. see <a href="#provenance-services" class="sectionRef"></a>).
+          The presence of a <code>hasProvenance</code> link in an HTTP response does not preclude the possibility that other publishers may offer provenance information about the same resource.  In such cases, discovery of the additional provenance information must use other means (e.g. see <a href="#provenance-services" class="sectionRef"></a>).
         </p>
         <p>
           Provenance resources indicated in this way are not guaranteed to be authoritative.  Trust in the linked 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 linked resource; e.g. based on the domain that serves it, or an associated digital signature. (See also <a href="#security-considerations" class="sectionRef"></a>.)
@@ -388,15 +389,15 @@
         <section>
           <h2>Specifying Provenance Services</h2>
             <p>
-              The resource provider may indicate that provenance information about the resource is provided by a <a class="internalDFN">provenance service</a>. This is done through the use of a <code>provenance-service</code> link relation type following the same pattern as above:
+              The resource provider may indicate that provenance information about the resource is provided by a <a class="internalDFN">provenance service</a>. This is done through the use of a <code>hasProvenanceService</code> link relation type following the same pattern as above:
             </p>
             <pre class="pattern">
-Link: <cite>provenance-service-URI</cite>; anchor="<cite>target-URI</cite>"; rel="provenance-service"</pre>
+Link: <cite>provenance-service-URI</cite>; rel="http://www.w3.org/ns/prov#hasProvenanceService"; anchor="<cite>target-URI</cite>"</pre>
             <p>
-              The <code>provenance-service</code> link identifies the <a class="internalDFN">service-URI</a>.  Dereferencing this URI yields a service description that provides further information to enable a client to determine a <a class="internalDFN">provenance-URI</a> or retrieve <a class="internalDFN">provenance information</a> for a <a class="internalDFN">resource</a>; see <a href="#provenance-services" class="sectionRef"></a> for more details.
+              The <code>hasProvenanceService</code> link identifies the <a class="internalDFN">service-URI</a>.  Dereferencing this URI yields a service description that provides further information to enable a client to determine a <a class="internalDFN">provenance-URI</a> or retrieve <a class="internalDFN">provenance information</a> for a <a class="internalDFN">resource</a>; see <a href="#provenance-services" class="sectionRef"></a> for more details.
             </p>
             <p>
-            There may be multiple <code>provenance-service</code> link header fields, and these may appear in an HTTP response together with <code>provenance</code> link header fields (though, in simple cases, we anticipate that <code>provenance</code> and <code>provenance-service</code> link relations will not be used together).
+            There may be multiple <code>hasProvenanceService</code> link header fields, and these may appear in an HTTP response together with <code>hasProvenance</code> link header fields (though, in simple cases, we anticipate that <code>hasProvenance</code> and <code>hasProvenanceService</code> link relations will not be used together).
           </p>
         </section>
 
@@ -404,17 +405,14 @@
 
       <section>
         <h2>Resource represented as HTML</h2>
-        <p class="TODO">
-          @@TODO: Use URIs for link relations (?)
-        </p>
         <div>
           For a document presented as HTML or XHTML, without regard for how it has been obtained, provenance information may be associated with a resource by adding a <code>&lt;link&gt;</code> element to the HTML <code>&lt;head&gt;</code> section.
-          Two new link relation types for referencing provenance information are registered according to the template in <a href="#iana-considerations" class="sectionRef"></a>, and may be used as shown:
+          Two link relation types for referencing provenance information may be used as shown:
           <pre class="pattern">
   &lt;html xmlns="http://www.w3.org/1999/xhtml"&gt;
      &lt;head&gt;
-        &lt;link rel="provenance" href="<cite>provenance-URI</cite>"&gt;
-        &lt;link rel="anchor" href="<cite>target-URI</cite>"&gt;
+        &lt;link rel="http://www.w3.org/ns/prov#hasProvenance" href="<cite>provenance-URI</cite>"&gt;
+        &lt;link rel="http://www.w3.org/ns/prov#hasAnchor" href="<cite>target-URI</cite>"&gt;
         &lt;title&gt;Welcome to example.com&lt;/title&gt;
      &lt;/head&gt;
      &lt;body&gt;
@@ -423,21 +421,16 @@
   &lt;/html&gt;</pre>
    </div>
         <p>
-          The <code><cite>provenance-URI</cite></code> given by the <code>provenance</code> link element identifies the provenance-URI for the document.
-        </p>
-        <p>
-          The <code><cite>target-URI</cite></code> given by the <code>anchor</code> link element specifies an identifier for the document that may be used within the provenance information when referring to the document.
+          The <code><cite>provenance-URI</cite></code> given by the <code>hasProvenance</code> link element identifies the provenance-URI for the document.
         </p>
         <p>
-          An HTML document header MAY include multiple <code>provenance</code> link elements, indicating a number of different provenance sources that are known to the creator of the document, each of which may provide provenance information about the document. 
+          The <code><cite>target-URI</cite></code> given by the <code>hasAnchor</code> link element specifies an identifier for the document that may be used within the provenance information when referring to the document.
         </p>
-<!--
         <p>
-          Likewise, the header MAY include multiple "anchor" link elements indicating that, e.g., different revisions of the document can be identified in the provenance information using the different  <code><cite>resource-URIs</cite></code>.
+          An HTML document header MAY include multiple <code>hasProvenance</code> link elements, indicating a number of different provenance sources that are known to the creator of the document, each of which may provide provenance information about the document. 
         </p>
--->
         <p>
-          If no "anchor" link element is provided then the <code><cite>target-URI</cite></code> is assumed to be the URI of the document. It is RECOMMENDED that this convention be used only when the document is static and has a stable URI that is reasonably expected to be available to anyone accessing the document (e.g. when delivered from a web server, or as part of a MIME structure containing content identifiers [[RFC2392]]).
+          If no <code>hasAnchor</code> link element is provided then the <code><cite>target-URI</cite></code> is assumed to be the URI of the document. It is RECOMMENDED that this convention be used only when the document is static and has a stable URI that is reasonably expected to be available to anyone accessing the document (e.g. when delivered from a web server, or as part of a MIME structure containing content identifiers [[RFC2392]]).
         </p>
 
         <section>
@@ -448,8 +441,8 @@
             <pre class="pattern">
   &lt;html xmlns="http://www.w3.org/1999/xhtml"&gt;
      &lt;head&gt;
-        &lt;link rel="provenance-service" href="<cite>service-URI</cite>"&gt;
-        &lt;link rel="anchor" href="<cite>target-URI</cite>"&gt;
+        &lt;link rel="http://www.w3.org/ns/prov#hasProvenanceService" href="<cite>service-URI</cite>"&gt;
+        &lt;link rel="http://www.w3.org/ns/prov#hasAnchor" href="<cite>target-URI</cite>"&gt;
         &lt;title&gt;Welcome to example.com&lt;/title&gt;
      &lt;/head&gt;
      &lt;body&gt;
@@ -457,10 +450,10 @@
      &lt;/body&gt;
   &lt;/html&gt;</pre>
           <p>
-            The <code>provenance-service</code> link element identifies the <a class="internalDFN">service-URI</a>.  Dereferencing this URI yields a service description that provides further information to enable a client to access <a class="internalDFN">provenance information</a> for a <a class="internalDFN">resource</a>; see <a href="#provenance-services" class="sectionRef"></a> for more details.
+            The <code>hasProvenanceService</code> link element identifies the <a class="internalDFN">service-URI</a>.  Dereferencing this URI yields a service description that provides further information to enable a client to access <a class="internalDFN">provenance information</a> for a <a class="internalDFN">resource</a>; see <a href="#provenance-services" class="sectionRef"></a> for more details.
           </p>
           <p>
-            There MAY be multiple <code>provenance-service</code> link elements, and these MAY appear in the same document as <code>provenance</code> link elements (though, in simple cases, we anticipate that <code>provenance</code> and <code>provenance-service</code> link relations would not be used together).
+            There MAY be multiple <code>hasProvenanceService</code> link elements, and these MAY appear in the same document as <code>provenance</code> link elements (though, in simple cases, we anticipate that <code>hasProvenance</code> and <code>hasProvenanceService</code> link relations would not be used together).
           </p>
         </section>
       </section>
@@ -468,18 +461,18 @@
       <section>
         <h2>Resource represented as RDF</h2>
         <p>
-          If a resource is represented as RDF (in any of its recognized syntaxes, including RDFa), it may contain references to its own provenance using additional RDF statements.  For this purpose three new RDF properties, <code>prov:hasProvenance</code>, <code>prov:hasAnchor</code>, and <code>prov:hasProvenanceService</code>, are defined as follows.
-          (These terms may be used to indicate provenance of other resources too, but discussion of such usage is beyond the scope of this section.)
+          If a resource is represented as RDF (in any of its recognized syntaxes, including RDFa), it may contain references to its own provenance using additional RDF statements.  For this purpose the link relations introduced above may be used as RDF properties: <code>prov:hasProvenance</code>, <code>prov:hasAnchor</code>, and <code>prov:hasProvenanceService</code>.
+          (These terms may be used to indicate provenance of arbitrary other resources too, but discussion of such usage is beyond the scope of this section.)
         </p>
         <p>
-          The RDF property <code>prov:hasProvenance</code> is defined as a relation between two resources, where the object of the property is a resource that provides provenance information about the subject resource.  Multiple <code>prov:hasProvenance</code> assertions may be made about a subject resource.  This property corresponds to a <a href="#registration-template-for-link-relation---provenance">provenance link relation</a> used with an HTTP <code>Link</code> header field, or HTML <code>&lt;link&gt;</code> element.
+          The RDF property <code>prov:hasProvenance</code> is a relation between two resources, where the object of the property is a resource that provides provenance information about the subject resource.  Multiple <code>prov:hasProvenance</code> assertions may be made about a subject resource.  This property corresponds to a <code>hasProvenance</code> e link relation</a> used with an HTTP <code>Link</code> header field, or HTML <code>&lt;link&gt;</code> element (see above).
         </p>
         <p>
-          Property <code>prov:hasAnchor</code> specifies a <a class="internalDFN">target-URI</a> used in the provenance information to refer to the containing RDF document.
-          This corresponds to use of the <code>anchor</code> parameter in an HTTP provenance <code>Link</code> header field, or an <a href="#registration-template-for-link-relation---anchor">anchor link relation</a> in an HTML <code>&lt;link&gt;</code> element, which similarly indicate a URI used by the provenance information to refer to the described document.
+          Property <code>prov:hasAnchor</code> specifies a <a class="internalDFN">target-URI</a> used in the indicated provenance information to refer to the containing RDF document.
+          This corresponds to use of the <code>anchor</code> parameter in an HTTP provenance <code>Link</code> header field, or a <code>hasAnchor</code> link relation</a> in an HTML <code>&lt;link&gt;</code> element, which similarly indicate a URI used by the provenance information to refer to the described document.
         </p>
         <p>
-          Property <code>prov:hasProvenanceService</code> specifies a <a class="internalDFN">service-URI</a> associated with the RDF document for possible access to provenance information.  This property corresponds to a <a href="#registration-template-for-link-relation---provenance-service">provenance-service link relation</a> used with an HTTP <code>Link</code> header field, or HTML <code>&lt;link&gt;</code> element.
+          Property <code>prov:hasProvenanceService</code> specifies a <a class="internalDFN">service-URI</a> associated with the RDF document for possible access to provenance information.  This property corresponds to a <code>hasProvenanceService</code> link relation used with an HTTP <code>Link</code> header field, or HTML <code>&lt;link&gt;</code> element.
         </p>
         <pre class="example code">
     @prefix prov: &lt;http://www.w3.org/ns/prov#&gt;
@@ -552,7 +545,7 @@
           The RDF service description example below in <a href="#provenance-service-description" class="sectionRef"></a> shows this use.
         </p>
         <p class="TODO">
-          @@TODO: sync up term definitions with provenance ontology specification.
+          @@TODO: rework the above to take account of hasProvenanceService links
         </p>
       </section>
 
@@ -584,6 +577,10 @@
     <section>
     <h2>Best practice</h2> 
 
+      <p class="TODO">
+        @@TODO: rtemove this section; cover in FAQ
+      </p>
+
       <section id="querying-provenance-information">
         <h2>Using SPARQL for provenance queries</h2>
         <p>
@@ -697,94 +694,6 @@
 <!-- ==== Section 6 ===================================================================================== -->
 
     <section>
-      <h2>IANA considerations</h2>
-      <p>This document requests registration of new link relations, per <a href="http://tools.ietf.org/html/rfc5988#section-6.2.1">section-6.2.1 of RFC 5988</a>.
-      </p>
-      <p class="TODO">
-          @@TODO The following templates should be completed and submitted to link-relations@ietf.org, or this section removed if URIs are used for link relations in ยง3:  Use some material for  table of UREIs introduced.
-      </p>
-      <section>
-        <h2>Registration template for link relation: "provenance"</h2>
-          <dl>
-            <dt>Relation Name:</dt>
-            <dd>
-              <code>provenance</code>
-            </dd>
-            <dt>Description:</dt>
-            <dd>
-              the resource identified by target IRI of the link provides provenance information about the resource identified by the context link
-            </dd>
-            <dt>Reference:</dt>
-            <dd>
-              @@this spec, @@provenance-model-spec
-            </dd>
-            <dt>Notes:</dt>
-            <dd>
-              ...
-            </dd>
-            <dt>Application Data:</dt>
-            <dd>
-              ...
-            </dd>
-          </dl>
-       
-      </section>
-      <section>
-        <h2>Registration template for link relation: "anchor"</h2>
-          <dl>
-            <dt>Relation Name:</dt>
-            <dd>
-              <code>anchor</code>
-            </dd>
-            <dt>Description:</dt>
-            <dd>
-              when used in conjunction with a "provenance" link, the resource identified by target IRI of the link is one for which provenance information may be provided.  This may be used, for example, to isolate relevant information from a referenced document that contains provenance information for several entities.
-            </dd>
-            <dt>Reference:</dt>
-            <dd>
-              @@this spec, @@provenance-model-spec
-            </dd>
-            <dt>Notes:</dt>
-            <dd>
-              ...
-            </dd>
-            <dt>Application Data:</dt>
-            <dd>
-              ...
-            </dd>
-          </dl>
-      </section>
-      <section>
-        <h2>Registration template for link relation: "provenance-service"</h2>
-          <dl>
-            <dt>Relation Name:</dt>
-            <dd>
-              <code>provenance-service</code>
-            </dd>
-            <dt>Description:</dt>
-            <dd>
-              the resource identified by target URI of the link is an provenance service per <a href="#provenance-services" class="sectionRef"></a> of this specification.
-            </dd>
-            <dt>Reference:</dt>
-            <dd>
-              @@this spec, @@provenance-model-spec
-            </dd>
-            <dt>Notes:</dt>
-            <dd>
-              ...
-            </dd>
-            <dt>Application Data:</dt>
-            <dd>
-              ...
-            </dd>
-          </dl>
-     
-      </section>
-    </section>
- 
-<!-- ==== Section 7 ===================================================================================== -->
-
-    <section>
       <h2>Security considerations</h2>
       <p>
         Provenance is central to establishing trust in data. If provenance information is corrupted, it may lead agents (human or software) to draw inappropriate and possibly harmful conclusions.  Therefore, care is needed to ensure that the integrity of provenance information is maintained.  Just as provenance information can help determine a level of trust in some information, provenance information related to the provenance itself ("provenance of provenance") can help determine trust in the provenance itself.
@@ -800,8 +709,6 @@
       </p>
       <p>Provenance information may be used by audits to establish accountability for information use [[INFO-ACC]] and to verify use of proper processes in information processing activities.  Thus, provenance management systems can provide mechanisms to support auditing and enforcement of information handling policies. In such cases, provenance information itself may be a valuable target for attack by malicious agents, and care must be taken to ensure it is stored securely and in a fashion that resists attempts to tamper with it.
       </p>
-
-
     </section>
  
 <!-- ===================================================================================== -->
@@ -821,7 +728,7 @@
     <section class='appendix'>
       <h2>Names added to prov: namespace</h2>
       <p class="TODO">
-          @@TODO Create table of URIs introduced, and what they mean.  Use some material from IOANA considerations.  Consider separate tables for classes and properties.
+          @@TODO Create table of URIs introduced, and what they mean.  Use some material from IANA considerations.  Consider separate tables for classes and properties.  Mainly need to add document cross-references, and review.
       </p>
 
       <p>
@@ -833,136 +740,37 @@
       </p>
         <table>
           <tr>
-            <th>name</th><th>Description</th><th>Definition ref</th>
-          </tr>
-          <tr>
-            <td>ProvenanceService</td><td>Class for a service described by a provenance service description</td><td>...</td>
+            <th>Name</th><th>Description</th><th>Ref</th>
           </tr>
           <tr>
-            <td>hasAnchor</td><td>Indicates anchor URI for a potentially dynamic resource instance</td><td>...</td>
+            <td>ProvenanceService</td>
+            <td>Class for a service described by a provenance service description, mainly for use in RDF service descriptions.</td>
+            <td>@@ref</td>
           </tr>
           <tr>
-            <td>hasProvenance</td><td>Relates a resource to its provenance</td><td>...</td>
+            <td>hasAnchor</td>
+            <td>Indicates a <a class="internalDFN">target-URI</a>target-URI for a potentially dynamic resource instance</td>
+            <td>...</td>
           </tr>
           <tr>
-            <td>hasProvenanceService</td><td>Relates a resource to a provenance service</td><td>...</td>
+            <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>@@ref</td>
           </tr>
           <tr>
-            <td>provenanceUriTemplate</td><td>Relates a provenance service to a URI template string for constructing provenance-URIs</td><td>...</td>
+            <td>hasProvenanceService</td>
+            <td>Indicates a <a class="internalDFN">provenance service</a> that can provide provenance information about its sibject or anchowresource.</td>
+            <td>@@ref</td>
+          </tr>
+          <tr>
+            <td>provenanceUriTemplate</td>
+            <td>Relates a provenance service to a URI template string for constructing provenance-URIs</td>
+            <td>@@ref</td>
           </tr>
         </table>
     </section>
 
-
-<!-- ===================================================================================== -->
-
-    <!-- 
-<section class='appendix'>
-      <h2>Provenance service format examples</h2>
-      <p>
-        In <a href="#provenance-services" class="sectionRef"></a>, the provenance service description was represented as a JSON-formatted document.  As noted, HTTP content negotiation MAY be enabled to retrieve the document in alternative formats.  This appendix provides examples of service description document represented using RDF Turtle and XML syntaxes, and XML. 
-      </p>
-
-      <section>
-        <h2>RDF Turtle example of service description</h2>
-        <p>
-          This example uses the RDF Turtle format [[TURTLE]], presented as MIME content-type <code>text/turtle</code>.
-        </p>
-        <pre class="example code">
-  @prefix provds: &lt;@@TBD@@#&gt; .
-  @prefix prov: &lt;http://www.w3.org/ns/prov-o/&gt; .
-  
-  &lt;http://example.org/provenance_service/&gt; a prov:ProvenanceService ;
-    provds:provenance_locations_template       "http://example.org/provenance_service/locations/?uri={uri}" ;
-    provds:provenance_content_template     "http://example.org/provenance_service/provenance/?uri={uri}"
-    .
-        </pre>
-        <p class="note">
-          The provenance URI templates are encoded in RDF as plain string literals, <em>not</em> as resource URIs.
-        </p>
-        <p class="TODO">
-          Finalize URIs in the above example.
-        </p>
-      </section>
-
-      <section>
-        <h2>RDF/XML example of service description</h2>
-        <p>This is essentially the same as the Turtle example above, but encoded in RDF/XML [[RDF-SYNTAX-GRAMMAR]], and presented as MIME content-type <code>application/xml+rdf</code>.</p>
-        <pre class="example code">
-  &lt;rdf:RDF
-    xmlns:rdf    = "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-    xmlns:rdfs   = "http://www.w3.org/2000/01/rdf-schema#"
-    xmlns:provds = "@@TBD@@#"
-    xmlns:prov   = "http://www.w3.org/ns/prov-o/"
-  &gt;
-    &lt;prov:ProvenanceService rdf:about="http://example.org/provenance_service/"&gt;
-     example.org &lt;provds:provenance_locations_template&gt;http://example.org/provenance_service/locations/?uri={uri}&lt;/provds:location_template&gt; ;
-      &lt;provds:provenance_content_template&gt;http://example.org/provenance_service/provenance/?uri={uri}&lt;/provds:provenance_template&gt; ;
-    &lt;/prov:ProvenanceService&gt;
-  &lt;/rdf:RDF&gt;
-        </pre>
-        <p class="TODO">
-          Finalize URIs in the above example.
-        </p>
-      </section>
-
-      <section>
-        <h2>Plain XML example of service description</h2>
-        <p class="TODO">
-          @@TODO: provide example and schema
-        </p>
-      </section>
-
-      <section>
-        <h2>RDF Turtle example of provenance locations</h2>
-        <p>
-          This example uses the RDF Turtle format [[TURTLE]], presented as MIME content type <code>text/turtle</code>.
-        </p>
-        <pre class="example code">
-  @prefix prov: &lt;@@TBD@@#&gt; .
-  &lt;http://example.org/qdata/&gt; a prov:Entity ;
-    prov:hasProvenance  &lt;http://source1.example.org/provenance/qdata/&gt; ;
-    prov:hasProvenance  &lt;http://source2.example.org/prov/qdata/&gt; ;
-    prov:hasProvenance  &lt;http://source3.example.com/prov?id=qdata&gt;
-    .
-        </pre>
-        <p class="issue">
-          NOTE: The namespace URI used here for the provenance properties is different from that used in the service description.  I am anticipating that it will be defined as part of the provenance model.  If it is not defined as part of the provenance model, then a property name should be allocated in the provenance discovery service namespace.
-        </p>
-        <p class="TODO">@@TODO: revise to conform with Provenance Model vocabulary; review URIs</p>
-      </section>
-
-      <section>
-        <h2>RDF/XML example of provenance locations</h2>
-        <p>
-          This is essentially the same as the Turtle example above, but encoded in RDF/XML [[RDF-SYNTAX-GRAMMAR]], and presented with MIME content type <code>application/rdf+xml</code>.
-        </p>
-        <pre class="example code">
-  &lt;rdf:RDF
-    xmlns:rdf    = "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-    xmlns:rdfs   = "http://www.w3.org/2000/01/rdf-schema#"
-    xmlns:prov   = "@@TBD@@#"
-  &gt;
-    &lt;prov:Entity rdf:about="http://example.org/qdata/"&gt;
-      &lt;prov:hasProvenance  rdf:resource="http://source1.example.org/provenance/qdata/" /&gt; ;
-      &lt;prov:hasProvenance  rdf:resource="http://source2.example.org/prov/qdata/" /&gt; ;
-      &lt;prov:hasProvenance  rdf:resource="http://source3.example.com/prov?id=qdata" /&gt; ;
-    &lt;/prov:Entity&gt;
-  &lt;/rdf:RDF&gt;
-        </pre>
-        <p class="TODO">@@TODO: revise to conform with Provenance Model vocabulary</p>
-      </section>
-
-      <section>
-        <h2>Plain XML example of provenance locations</h2>
-        <p class="TODO">
-          @@TODO: provide example and schema
-        </p>
-      </section>
-
-    </section>
- -->
-
 <!-- ===================================================================================== -->
 
   </body>