--- a/model/comments/issue-274-gk.txt	Fri Mar 23 09:53:33 2012 +0000
+++ b/model/comments/issue-274-gk.txt	Fri Mar 23 11:26:28 2012 +0000
@@ -134,10 +134,9 @@
  > just state that these are commonly encountered kinds of agent, and
  > leave it at that.
 
-"accountable system" is definitely topical.
-We definitely want to stay away from causality.
 
-I am not exactly sure what needs to be addressed here.
+The example about software agent was simplified. Indeed no need to mention responsibility here.
+This is left to section 2.4.
 
  > 
  > 

--- a/model/prov-dm.html	Fri Mar 23 09:53:33 2012 +0000
+++ b/model/prov-dm.html	Fri Mar 23 11:26:28 2012 +0000
@@ -471,13 +471,15 @@
 <section id="section-types-entities-agents"> 
 <h2>Agents and Other Types of Entities</h2>
 
+<p>The motivation for introducing  agents in the model is to denote the agent's responsibility for activities. </p>
+
 <p>
 <span class="glossary-ref" ref="glossary-agent"  withspan="true">
 </span>
 </p>
 
 
-<p>The motivation for introducing  agents in the model is to denote the agent's responsibility for activities. 
+<p>
 The definition of agent intentionally stays away from using concepts such as enabling, causing, initiating, affecting, etc, because many entities also enable, cause, initiate, and affect in some way
 the activities. Concepts such as initiating are themselves defined as relations between agent and activities.   So the notion of having some degree of responsibility is really what makes an agent.</p>
 
@@ -493,7 +495,7 @@
 
 
 
-<p>There are some useful types of entities and agents that are commonly encountered in applications making data and documents available on the Web; we introduce them in this section. </p>
+<p>There are some useful types of entities and agents that are commonly encountered in applications making data and documents available on the Web; we introduce them in the rest of this section. </p>
 
 <p>
 <span class="glossary-ref" ref="glossary-plan"  withspan="true">
@@ -512,6 +514,15 @@
 </p>
 </div>
 
+
+
+<p>Three types of agents are recognized by PROV-DM because they are commonly encountered in applications making data and documents available on the Web: persons, software agents, and organizations.</p>
+
+<div class="anexample" id="types-of-agents-example">
+<p> A Web site and service selling books on the Web and the company hosting 
+them are software agents and organizations, respectively.</p>
+</div>
+
 <p>
 <span class="glossary-ref" ref="glossary-collection"  withspan="true"></span> This concept allows for the provenance of the collection, but also of its constituents to be expressed.  Such a notion of collection corresponds to a wide variety of  concrete data structures, such as a <em>maps</em>, <em>dictionaries</em> or <em>associative arrays</em>.</p>
 
@@ -538,25 +549,19 @@
 </p>
 </div>
 
-
-<p>Three types of agents are recognized by PROV-DM because they are commonly encountered in applications making data and documents available on the Web: persons, software agents, and organizations.</p>
-
-<div class="anexample" id="software-agents-example">
-<p> Even software agents can be assigned some responsibility for the effects they have, so for example if one is using a Text Editor and one's laptop crashes, then one would say
-that the Text Editor was responsible for crashing the laptop.  If one invokes a service to buy a book, that service can be considered responsible for drawing funds from one's bank to make
-the purchase (the company that runs the service and the web site would also be responsible, but the point here is that we assign some measure of responsibility to software as well). </p>
-</div>
-<p>So when
-someone models software as an agent for an activity in the PROV-DM model, they mean the agent has some responsibility for that activity.</p>
 </section>
 
 
 <section id="section-attribution-association-responsibility"> 
 <h2>Attribution, Association, and Responsibility</h2>
 
-  
-
-
+<p>Agents can be related to entities, activities, and other agents.</p>  
+
+<div class="glossary-ref" ref="glossary-attribution" withspan="true"></div>
+
+<div class="anexample" id="association-example">
+<p>A blog post can be attributed to an author, a mobile phone to its manufacturer.</p>
+</div>
 
 <p>
 Agents are defined as having some kind of responsibility for activities. However, one may want to be more specific about the nature of an agent's responsibility. 
@@ -653,8 +658,8 @@
 
 <div style="text-align: center; ">
   <figure style="max-width: 70%; " >
-  <img src="images/OverviewDiagram.png" alt="PROV-DM overview" style="max-width: 70%; "  />
-<figcaption id="prov-dm-overview">PROV-DM overview</figcaption>
+  <img src="images/OverviewDiagram.png" alt="Simplified  Overview of PROV-DM" style="max-width: 70%; "  />
+<figcaption id="prov-dm-overview">Simplified  Overview of PROV-DM</figcaption>
   </figure>
 </div>