--- a/model/working-copy/wd5-prov-dm-components.html Sun Mar 18 21:12:35 2012 +0000
+++ b/model/working-copy/wd5-prov-dm-components.html Sun Mar 18 21:57:34 2012 +0000
@@ -847,35 +847,58 @@
<h2>PROV-DM Concepts</h2>
+<p>PROV-DM Concepts are structured according to six components that are introduced here.
+Components and their dependencies are illustrated in Figure <a href="#prov-dm-components">prov-dm-components</a>. A component that relies on concepts defined in another also sits above it, in this figure.
+PROV-DM consists of the following components.</p>
+
+<ol>
+<li><b>Component 1: entities and activities.</b> The first component consists of entities, activities, and all concepts linking them, such as generation, usage, start, end. The first component is the only one comprising time-related concepts. </li>
+<li><b>Component 2: agents and responsibility.</b> The second component consists of agents and concepts ascribing responsibility to agents.</li>
+<li><b>Component 3: derivations.</b> The third component is formed with derivations and its subtypes.</li>
+<li><b>Component 4: alternate.</b> The fourth component consists of relations linking entities somehow denoting a same thing. </li>
+<li><b>Component 5: collections.</b> The fifth component is comprised of collections and operations related to collections. </li>
+<li><b>Component 6: annotations.</b> The sixth component is concerned with annotations to PROV-DM concepts.</li>
+</li>
+
<div style="text-align: center;">
<figure style="max-width: 90%; ">
<img usemap="#componentMap" src="../images/components.png" alt="PROV-DM Components" style="max-width: 90%; " />
<map id="componentMap" name="componentMap">
-<area title="collections" href="#component5" coords="200,0,300,100" alt="collections" shape="rect"/>
-<area title="annotations" href="#component6" coords="450,180,500,280" alt="annotations" shape="rect"/>
+<area title="collections" href="#component5" coords="220,0,440,70" alt="collections" shape="rect"/>
+<area title="alternate" href="#component4" coords="450,0,510,140" alt="alternate" shape="rect"/>
+<area title="annotations" href="#component6" coords="530,0,590,220" alt="annotations" shape="rect"/>
+<area title="activities/entities" href="#component1" coords="80,150,510,220" alt="activities/entities" shape="rect"/>
+<area title="derivations" href="#component3" coords="80,0,210,70" alt="derivations" shape="rect"/>
+<area title="agents/responsibility" href="#component2" coords="0,0,70,220" alt="agents/responsibility" shape="rect"/>
</map>
-<figcaption>PROV-DM Components</figcaption>
+<figcaption id="prov-dm-components">PROV-DM Components</figcaption>
</figure>
</div>
+<p>
+While not all PROV-DM relations are binary, they all involve two primary elements. Hence, Table <a href="#relations-at-a-glance">relations-at-a-glance</a> indexes all relations according to their two primary elements. The table adopts the same color scheme as in Figure <a href="#prov-dm-components">prov-dm-components</a>, allowing components to be readily identified.
+Note that for simplicity, this table does not include collection-oriented relations.
+</p>
<div style="text-align: center;">
<table border="1" style="margin-left: auto; margin-right: auto;">
-<caption>PROV-DM Relation Summary</caption>
+<caption id="relations-at-a-glance">PROV-DM Relations At a Glance</caption>
<tr><td></td><td>Entity</td><td>Activity</td><td>Agent</td><td>Note</td></tr>
<tr><td>Entity</td><td><div class="component3-color"><a>wasDerivedFrom</a><br><a>wasRevisionOf</a><br><a>wasQuotedFrom</a><br><a>hadOriginalSource</a></div><div class="component4-color"><a>alternateOf</a><br><a>specializationOf</a></div></td><td class="component1-color"><a
title="dfn-Generation">wasGeneratedBy</a></td><td class="component2-color"><a>wasAttributedTo</a></td><td class="component6-color"><a>hasAnnotation</a></td></tr>
-<tr><td>Activity</td><td><div class="component1-color"><a>used</a><br><a>wasStartedBy</a><br><a>wasEndedBy</a></div></td><td style="background:rgba(255,42,42,0.2); "><a>wasStartedByActivity</a><br><a>wasInformedBy</a></td><td class="component2-color"><a>wasAssociatedWith</a></td><td class="component6-color"><a>hasAnnotation</a></td></tr>
+<tr><td>Activity</td><td><div class="component1-color"><a>used</a><br><a>wasStartedBy</a><br><a>wasEndedBy</a></div></td><td class="component1-color"><a>wasStartedByActivity</a><br><a>wasInformedBy</a></td><td class="component2-color"><a>wasAssociatedWith</a></td><td class="component6-color"><a>hasAnnotation</a></td></tr>
<tr><td>Agent</td><td>—</td><td>—</td><td class="component2-color"><a>actedOnBehalfOf</a></td><td class="component6-color"><a>hasAnnotation</a></td></tr>
<tr><td>Note</td><td>—</td><td>—</td><td>—</td><td class="component6-color"><a>hasAnnotation</a></td></tr>
</table>
</div>
+<p>Table <a href="#prov-dm-concepts-and-relations">prov-dm-concepts-and-relations</a> is a complete index of all the concepts and relations in prov-dm, color-coded according to the component they belong too. In the first column, one finds concept names directly linking to their English definition. In the second column, we find their representation in the PROV-N notation, directly linking to the definition of their various constituents.</p>
+
<div style="text-align: left;">
<table border="1" style="margin-left: auto; margin-right: auto;">
-<caption>PROV-DM Concepts and Relations</caption>
+<caption id="prov-dm-concepts-and-relations">PROV-DM Concepts and Relations</caption>
<tr class="component1-color"><td><a>Entity</a></td><td><a title="dfn-Entity">entity(id, [ attr1=val1, ...])</a></td></tr>
<tr class="component1-color"><td><a>Activity</a></td><td><a title="dfn-Activity">activity(id, st, et, [ attr1=val1, ...])</a></td></tr>
<tr class="component1-color"><td><a>Generation</a></td><td><a title="dfn-Generation">wasGeneratedBy(id,e,a,t,attrs)</a></td></tr>
@@ -906,6 +929,7 @@
</table>
</div>
+<p>In the rest of the section, each concept and relation is defined, in English initially, followed by a more formal definition and some example.</p>
<section id="component1">
<h3>Component 1: Entities and Activities</h3>
@@ -1378,7 +1402,7 @@
<section id="term-responsibility">
-<h4>Responsibility Chain</h4>
+<h4>Responsibility</h4>
<div class="glossary-ref" ref="glossary-responsibility"></div>