added some explanation
authorPaul Groth <p.t.groth@vu.nl>
Tue, 05 Feb 2013 18:30:46 +0100
changeset 5478 2e03f5852bfd
parent 5477 6644ac2782f3
child 5479 158512454441
added some explanation
reports/prov-implementations.html
--- a/reports/prov-implementations.html	Tue Feb 05 17:23:18 2013 +0100
+++ b/reports/prov-implementations.html	Tue Feb 05 18:30:46 2013 +0100
@@ -79,17 +79,43 @@
   <body xmlns:prov="http://www.w3.org/ns/prov-o/"> 
 
     <section id="abstract">
-      <p>This document summarises implementation experience reported to the Provenance Working Group.</p>
+      <p>This document reports on implementations and usage of the PROV Family of Documents [[PROV-OVERVIEW]]. In particular, it's aim is to demonstrate that the features defined in PROV are implementable and interoperable. Features are defined as: the constructs specified in [[PROV-DM]] and their realisation in OWL (see [[PROV-O]]) and in the [[PROV-N]] syntax; the constraints defined within [[PROV-CONSTRAINTS]]. Interoperability is defined through both the interchange of provenance information and the coverage of test cases.     </p>
     </section>
 	<section id="sotd">
-      <b>Editors' working copy can change at any time. </b>
+      During the Candidate Recommendation period of PROV, implementation experience was reported. This document summarises those experiences. 
+
+For comments, please send a mail to <a href="mailto:public-prov-comments@w3.org">public-prov-comments@w3.org</a> [<a href="http://lists.w3.org/Archives/Public/public-prov-comments/">archive</a>].
     </section>
     
+    <section id="Introduction">
+    <h2>Introduction</h2>
+    The goal of PROV is to enable interoperable interchange of provenance on the Web. We take two approaches to documenting the implementation and interoperability of PROV. 
+    <ol>
+    <li> For the data model [[PROV-DM]] and the two working group defined serializations, we document that there are multiple implementations that support each of the constructs defined by the data model and that there are at least two implementations that are reported to exchange these constructs. </li>
+    <li> We document that the PROV-Constraints specification is implementable. To evaluate the coverage of implementations, the <a href="https://dvcs.w3.org/hg/prov/raw-file/default/testcases/process.html">PROV-Constraints Test Cases</a> are used as a point of reference. There are 280 test cases in total, which map to the the constraints defined by the document. </li>
+    </ol>
+<p>
+PROV is useful not only for applications/programs but also for exposing provenance within dataset and as a foundation for other vocabularies. We also document that usage as well. 
+</p>
+<p>
+Implementation evidence was gathered using four surveys. 
+<ul>
+<li><a href="https://www.w3.org/2002/09/wbs/46974/prov-implementation-survey/results">Implementations in software</a></li>
+<li><a href="https://www.w3.org/2002/09/wbs/46974/prov-vocabulary-usage-survey/results">Usage in datasets or the web</a></li>
+<li><a href="https://www.w3.org/2002/09/wbs/46974/prov-vocabulary-survey/results">Extensions of the PROV vocabulary</a></li>
+<li><a href="https://www.w3.org/2002/09/wbs/46974/prov-constraints/results">Implementations of PROV-Constraints</a></li>
+</ul>
+This report summarises the results of these surveys.
+
+</p>
+    </section>
     <section id="implementations">
       <h2>Implementations</h2>
-      <p>Implementation Type:
+   
+      The following lists the reported implementations, the type of implementation, supported PROV encodings and the URL of the implementation. 
+         <p>Implementation Type:
         <ul>
-            <li>Application:</li>
+            <li>Application</li>
             <li>Framework/API</li>
             <li>Service</li>
             <li>Vocabulary</li>
@@ -128,7 +154,7 @@
     <p>This section enumerates the PROV-DM terms [[PROV-DM]] that are consumed (<img src="consume.png" width="27" height="16" alt="Consume Icon" />),
     produced (<img src="produce.png" width="27" height="16" alt="Produce Icon" />),
     or both consumed and produced (<img src="conprod.png" width="27" height="16" alt="Consume and Produce Icon" />)
-    by a particular implementation.</p>
+    by a particular implementation.</p> Hover, over the numbers to see the implementation name.
     <table class="feature-table">
       <caption id="prov-terms-table">Table 2: Coverage of PROV-DM terms in implementations of type Application, Framework / API, or Service.</caption>
       <tr>