Further feedback from Olaf
authorGraham Klyne
Mon, 09 Jan 2012 20:54:07 +0000
changeset 1352 413cd9cccaba
parent 1351 002d8009c230
child 1353 9628aaff6e20
Further feedback from Olaf
paq/prov-aq.html
--- a/paq/prov-aq.html	Mon Jan 09 15:13:58 2012 +0000
+++ b/paq/prov-aq.html	Mon Jan 09 20:54:07 2012 +0000
@@ -328,7 +328,7 @@
               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 an <a class="internalDFN">entity</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 the same HTTP response as <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>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).
           </p>
         </section>
 
@@ -395,17 +395,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.  (The same RDF 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 three new RDF properties, <code>prov:hasProvenance</code>, <code>prov:hasAnchor</code>, and <code>prov:hasProvenanceService</code>, are defined in the following.
+          (These terms may be used to indicate provenance of other resources too, but discussion of such usage is beyond the scope of this section.)
         </p>
         <p>
-          For this purpose a new 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 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.
         </p>
         <p>
-          The RDF property, <code>prov:hasAnchor</code>, is defined to allow the RDF content to specify an <a class="internalDFN">entity-URI</a> used in the provenance information to refer to the RDF document.
+          Property <code>prov:hasAnchor</code> specifies an <a class="internalDFN">entity-URI</a> used in the provenance information to refer to the RDF document.
           This corresponds to use of the "anchor" 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.
         </p>
         <p>
-          Another new RDF property, <code>prov:hasProvenanceService</code>, is defined to allow the RDF content to specify one or more <a class="internalDFN">service-URI</a>s 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>s 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.
         </p>
         <p class="TODO">
           @@TODO: document namespace.  Check naming style.  Use provenance model namespace?  Define as part of model?<br/>