update following Graham's comments
authorLuc Moreau <l.moreau@ecs.soton.ac.uk>
Tue, 29 May 2012 12:33:39 +0100
changeset 3029 51c1fe338db9
parent 3028 0fc6a6ee40f0
child 3030 58ab3cacb8ec
update following Graham's comments
model/comments/wd6-Graham.txt
model/prov-dm.html
--- a/model/comments/wd6-Graham.txt	Tue May 29 10:25:58 2012 +0100
+++ b/model/comments/wd6-Graham.txt	Tue May 29 12:33:39 2012 +0100
@@ -550,6 +550,10 @@
   > [[
   > A /provenance description/ is a set of assertions based on the core and extended provenance structures described below.
   > ]]
+
+I added "provenance description is an instance of a core and extended 
+provenance structure described below."
+
   > 
   > I see the term "provenance description" is used throughout the
   > document, but I see no definition.  Many of the uses are fine - being
@@ -559,6 +563,9 @@
   > As it is, if the above description is correct, a bundle should be
   > described as a named provenance description (not a set of
   > descriptions).
+
+With the above definition, we can keep the definition of bundle.
+
   > 
   > ....
   > 
@@ -593,6 +600,9 @@
   > == Section 5 ==
   > 
   > I'd still like to see derivations immediately follow entities/activities.  :)
+
+I swapped component 2 and 3.
+
   > 
   > Figure 4: I don't know what this is trying to tell me.
   > 
--- a/model/prov-dm.html	Tue May 29 10:25:58 2012 +0100
+++ b/model/prov-dm.html	Tue May 29 12:33:39 2012 +0100
@@ -288,8 +288,8 @@
  to form assessments about its quality, reliability or trustworthiness.
 PROV-DM is the conceptual data model that forms a basis for the W3C
 provenance (PROV) family of specifications.
-PROV-DM distinguishes core structures, forming the essence of provenance descriptions, from
-extended structures catering for more advanced uses of provenance. 
+PROV-DM distinguishes core structures, forming the essence of provenance information, from
+extended structures catering for more specific uses of provenance. 
 PROV-DM is organized in six components, respectively dealing with: 
 (1) entities and activities, and the time at which they were created, used, or ended;
 (2) agents bearing responsibility for entities that were generated and activities that happened;
@@ -306,7 +306,7 @@
 
 <p>Two further documents complete the specification of PROV-DM.
 First, a companion document specifies the set of constraints that
-provenance descriptions should follow.  Second, 
+provenance should follow.  Second, 
 a separate document describes a provenance notation for expressing 
 instances of provenance for human consumption; this notation is used in examples in
 this document. </p>
@@ -412,7 +412,7 @@
 <p>
 The PROV data model distinguishes <em>core structures</em> from
 <em>extended structures</em>: core structures form the essence of
-provenance descriptions, and are commonly found in various
+provenance information, and are commonly found in various
 domain-specific vocabularies that deal
 with provenance or similar kinds of information [[Mappings]].
 Extended structures enhance and refine core
@@ -437,13 +437,13 @@
 
 <p>This specification presents the concepts of the PROV Data Model, and
 provenance types and relations, without specific concern for how they are applied.
-With these, it becomes possible to write useful provenance descriptions, and publish or embed them alongside the data they relate to. </p>
+With these, it becomes possible to write useful provenance, and publish or embed it alongside the data it relates to. </p>
 
 <p>However, if something about which provenance is expressed is subject to change, then it is challenging to express its provenance precisely (e.g. the data from which a daily weather report is derived  changes from day to day).
 This is addressed in a companion
  specification [[PROV-CONSTRAINTS]] by proposing formal constraints on
- the way that provenance descriptions are related to the things they
- describe (such as the use of attributes, temporal information and
+ the way that provenance is related to the things it
+ describes (such as the use of attributes, temporal information and
  specialization of entities), and additional conclusions that are valid
  to infer.
 </p>
@@ -452,9 +452,9 @@
 <section id="structure-of-this-document"> 
 <h3>Structure of this Document</h3>
 
-<p><a href="#section-prov-overview">Section 2</a> provides an overview of the PROV Data Model,  distinguishing a core set of types and  relations, commonly found in provenance descriptions, from extended structures catering for more specific uses. It also introduces a modular organization of the data model in components. </p>
-
-<p><a href="#prov-notation">Section 3</a> overviews the Provenance Notation used to illustrate examples of provenance descriptions.</p>
+<p><a href="#section-prov-overview">Section 2</a> provides an overview of the PROV Data Model,  distinguishing a core set of types and  relations, commonly found in provenance, from extended structures catering for more specific uses. It also introduces a modular organization of the data model in components. </p>
+
+<p><a href="#prov-notation">Section 3</a> overviews the Provenance Notation used to illustrate examples of provenance.</p>
 
 
 <p><a href="#prov-dm-example">Section 4</a> illustrates how the PROV data model can be used
@@ -467,7 +467,7 @@
 
 <p><a href="#extensibility-section">Section 6</a> summarizes PROV-DM extensibility points.</p>
 
-<p><a href="#valid-provenance">Section 7</a> introduces the idea that constraints can be applied to the PROV data model to validate provenance descriptions; these are covered in the companion specification [[PROV-CONSTRAINTS]].</p>
+<p><a href="#valid-provenance">Section 7</a> introduces the idea that constraints can be applied to the PROV data model to validate provenance; these are covered in the companion specification [[PROV-CONSTRAINTS]].</p>
 
 
 </section> 
@@ -511,8 +511,8 @@
 <section id='section-prov-overview'> 
 <h1>PROV Overview</h1>
 
-<p>This section introduces provenance concepts with informal descriptions and illustrative
-examples. PROV distinguishes  <em>core structures</em>, forming the essence of  provenance descriptions, from <em>extended structures</em> catering for more advanced uses of provenance.  Core and extended structures are respectively presented in <a href="#core-structures">Section 2.1</a> and <a href="#section-extended-structures">Section 2.2</a>. Furthermore, the PROV data model is organized according to components, which form thematic groupings of concepts (see <a href="#section-overview-components">Section 2.3</a>).
+<p>This section introduces provenance concepts with informal explanations and illustrative
+examples. PROV distinguishes  <em>core structures</em>, forming the essence of  provenance, from <em>extended structures</em> catering for more advanced uses of provenance.  Core and extended structures are respectively presented in <a href="#core-structures">Section 2.1</a> and <a href="#section-extended-structures">Section 2.2</a>. Furthermore, the PROV data model is organized according to components, which form thematic groupings of concepts (see <a href="#section-overview-components">Section 2.3</a>). A <em>provenance description</em> is an instance of  a core and extended provenance structure described below.
 </p>