--- a/model/working-copy/towards-wd4.html Mon Feb 06 23:11:32 2012 +0000
+++ b/model/working-copy/towards-wd4.html Tue Feb 07 09:23:06 2012 +0000
@@ -484,7 +484,7 @@
activity(a1,2011-11-16T16:05:00,2011-11-16T16:06:00,
[ex:host="server.example.org",prov:type="ex:edit" %% xsd:QName])
</pre>
-<p>states the existence of an activity identified by <span class="name">a1</span>, start time <span class="name">2011-11-16T16:05:00</span>, and end time <span
+<p>states the existence of an activity with identifier <span class="name">a1</span>, start time <span class="name">2011-11-16T16:05:00</span>, and end time <span
class="name">2011-11-16T16:06:00</span>, running on host <span class="name">server.example.org</span>, and of type <span class="name">edit</span> (declared in some namespace with prefix
<span class="name">ex</span>). The attribute <span class="name">host</span> is application specific, but MUST hold for the duration of activity. The attribute <span
class="name">type</span> is a reserved attribute of PROV-DM, allowing for subtyping to be expressed.</p>
@@ -551,64 +551,36 @@
<section id="record-note">
-<h4>Note Record</h4>
+<h4>Note</h4>
-<p>As provenance records are exchanged between systems, it may be useful to add extra-information about such records. For instance, a "trust service" may add value-judgements about the
-trustworthiness of some of the assertions made. Likewise, an interactive visualization component may want to enrich a set of provenance records with information helping reproduce their
+<p>As provenance assertions are exchanged between systems, it may be useful to add extra-information about such assertions. For instance, a "trust service" may add value-judgements about the
+trustworthiness of some of the assertions made. Likewise, an interactive visualization component may want to enrich a set of provenance assertions with information helping reproduce their
visual representation. To help with inter-operability, PROV-DM introduces a simple annotation mechanism allowing any identifiable record to be associated with notes.</p>
-<p>A <dfn id="dfn-note">note record</dfn> is a set of attribute-value pairs, whose meaning is application specific. It may or may not be a representation of something in the world.</p>
-
-<div class="withAsn">
-<p>In PROV-ASN, a note record's text matches the <span class="nonterminal">noteRecord</span> production of the grammar defined in this specification document.
-</p>
+<p>A <dfn id="dfn-note">note</dfn> is a set of attribute-value pairs, whose meaning is application specific.</p>
-<div class='grammar'>
-<span class="nonterminal">noteRecord</span> ::=
-<span class="name">note</span>
-<span class="name">(</span>
-<span class="nonterminal">identifier</span>
-<span class="name">,</span>
-<span class="nonterminal">attribute-values</span>
-<span class="name">)</span><br/>
-<!-- -->
-</div>
-</div>
-
-<p>A separate PROV-DM record is used to associate a note with an identifiable record (see <a href="#record-annotation">Section on annotation</a>). A given note may be associated with
-multiple records.
+<p>A separate PROV-DM construct is used to associate a note with something that is identifiable (see <a href="#record-annotation">Section on annotation</a>). A given note may be associated with
+multiple asssertions.
</p>
<div class="anexample">
<p>
-The following note record consists of a set of application-specific attribute-value pairs, intended
-to help the rendering of the record it is associated with, by
+The following note consists of a set of application-specific attribute-value pairs, intended
+to help the rendering of the assertion it is associated with, by
specifying its color and its position on the screen.</p>
<pre class="codeexample">
note(ann1,[ex:color="blue", ex:screenX=20, ex:screenY=30])
hasAnnotation(g1,n1)
</pre>
-<p>The note record is associated with a record <span class="name">g1</span> previously introduced (<a title="annotation record">hasAnnotation</a> is
-discussed in Section <a href="#record-annotation">Annotation Record</a>). In this example,
+<p>The note is associated with an assertion <span class="name">g1</span> previously introduced (<a title="annotation record">hasAnnotation</a> is
+discussed in Section <a href="#record-annotation">Annotation</a>). In this example,
the attribute-value pairs do not constitute a representation of something
in the world; they are just used to help render provenance.
</p>
</div>
-<p>
-Attribute-value pairs occurring in notes differ from attribute-value pairs occurring in entity records and activity records. In entity and activity records, attribute-value pairs MUST be a
-representation of something in the world, which remain constant for the duration of the characterization interval (for entity record) or the activity duration (for activity records).
-A note record linked with an entity record consists of
-attribute-value pairs which may or may not represent the entity's
-situation in the world.
-If a note record's attribute-value pair represents an entity's situation
-in the world, no requirement is made on this situation to be unchanged for
-the entitys' characterization interval.
-</p>
-
-<div class='issue'> Comments on notes and their attributes appear in <a href="http://www.w3.org/2011/prov/track/issues/189">ISSUE-189</a>.</div>
</section>