primary source update
authorLuc Moreau <l.moreau@ecs.soton.ac.uk>
Mon, 11 Jun 2012 21:33:21 +0100
changeset 3273 2f5ebc45c9f4
parent 3272 445f205fb03e
child 3274 0f9b7ba8c35e
primary source update
model/glossary.html
model/glossary.js
model/prov-dm.html
--- a/model/glossary.html	Mon Jun 11 18:08:25 2012 +0100
+++ b/model/glossary.html	Mon Jun 11 21:33:21 2012 +0100
@@ -132,6 +132,14 @@
 </span>
 
 <span class="glossary" id="glossary-primary-source">  
+A <dfn id="concept-primary-source">primary source</dfn> 
+for a topic refers to something produced by some agent
+with direct experience and knowledge about the topic, at the time of
+the topic's study, without benefit from hindsight.
+</span>
+
+
+<span class="glossary" id="glossary-primary-source-old">  
 A <dfn id="concept-primary-source">primary source</dfn> refers to the
 source material that is closest to the person, information, period, or idea being studied.
 </span>
--- a/model/glossary.js	Mon Jun 11 18:08:25 2012 +0100
+++ b/model/glossary.js	Mon Jun 11 21:33:21 2012 +0100
@@ -3,7 +3,7 @@
 //  with <script src="glossary.js" class="remove"></script>
 //Insert glossary definitions with the following 
 // <div class="glossary-ref" ref="glossary-generation"></div>
-glossary_hg='http://dvcs.w3.org/hg/prov/file/addd455368f2/model/glossary.html';
+glossary_hg='http://dvcs.w3.org/hg/prov/file/445f205fb03e/model/glossary.html';
 glossary_string= 
 ' ' + 
 '<html> ' + 
@@ -139,6 +139,14 @@
 '</span> ' + 
 ' ' + 
 '<span class="glossary" id="glossary-primary-source">   ' + 
+'A <dfn id="concept-primary-source">primary source</dfn>  ' + 
+'for a topic refers to something produced by some agent ' + 
+'with direct experience and knowledge about the topic, at the time of ' + 
+'the topic\'s study, without benefit from hindsight. ' + 
+'</span> ' + 
+' ' + 
+' ' + 
+'<span class="glossary" id="glossary-primary-source-old">   ' + 
 'A <dfn id="concept-primary-source">primary source</dfn> refers to the ' + 
 'source material that is closest to the person, information, period, or idea being studied. ' + 
 '</span> ' + 
--- a/model/prov-dm.html	Mon Jun 11 18:08:25 2012 +0100
+++ b/model/prov-dm.html	Mon Jun 11 21:33:21 2012 +0100
@@ -2064,26 +2064,42 @@
 <span class="glossary-ref" data-ref="glossary-primary-source"></span>
 </p>
 
-<p>A <dfn>primary source</dfn> relation is a particular case of <a>derivation</a> 
-that aims to give
-credit to the source that originated some information. It is recognized that it may be
-hard to determine which entity constitutes a primary source. This definition is inspired by
+<p>Because of the directness of primary sources, they "speak for
+themselves" in ways that cannot be captured through the filter of
+secondary sources. As such, it is important for secondary sources to
+reference those primary sources from which they were derived, so that
+their reliability can be investigated.</p>
+
+
+<p>A <dfn>primary source</dfn> relation is a particular case of <a>derivation</a> of
+secondary materials from their primary sources. It is recognized that
+the determination of primary sources can be up to interpretation, and
+should be done according to conventions accepted within the
+application's domain.</p>
+
+<p>This definition is inspired by
 <span class="name">original-source</span> as defined in
 <a href="http://googlenewsblog.blogspot.com/2010/11/credit-where-credit-is-due.html">http://googlenewsblog.blogspot.com/2010/11/credit-where-credit-is-due.html</a>.</p>
 
-<!--
-<p> An <dfn title="hadOriginalSource">original source</dfn> relation<span class="withPn">, written <span class="pnExpression">hadOriginalSource(id; e2, e1, a, g2, u1, attrs)</span>,</span> has:</p>
-<ul>
-<li><span class='attribute' id="originalSource.id">id</span>:  an OPTIONAL identifier for the relation;</li> 
-<li><span class='attribute' id="originalSource.derived">derived</span>: an identifier (<span class="name">e2</span>) for the derived entity; </li>
-<li><span class='attribute' id="originalSource.source">source</span>: an identifier (<span class="name">e1</span>) for the original source entity;</li>
-<li><span class='attribute' id="originalSource.activity">activity</span>: an OPTIONAL identifier (<span class="name">a</span>) for the activity using and generating the above entities;</li>
-<li><span class='attribute' id="originalSource.generation">generation</span>: an OPTIONAL identifier (<span class="name">g2</span>) for the generation involving the generated entity (<span class="name">e2</span>) and activity;</li> 
-<li><span class='attribute' id="originalSource.usage">usage</span>: an OPTIONAL identifier (<span class="name">u1</span>) for the usage involving the used entity (<span class="name">e1</span>) and activity;</li> 
-<li><span class='attribute' id="originalSource.attributes">attributes</span>: an OPTIONAL set (<span class="name">attrs</span>) of attribute-value pairs representing additional information about this relation.</li>
-</ul>
--->
-<div class="anexample">
+<div class="anexample" id="anexample-primary-source1">
+<p>
+Let us consider Charles Joseph Minard's flow map of Napoleon's March in
+1812, which was published in 1869. Although the map is not a primary source,
+Minard probably used the journal of Pierre-Irénée Jacob, pharmacist
+to Napoleon's army during the Russian campaign. This primary source relation
+can be encoded as follows.</p>
+
+<pre class="codeexample">
+entity(ex:la-campagne-de-Russie-1812-1813)
+entity(ex:revue-d-Histoire-de-la-Pharmacie-t-XVIII)
+wasDerivedFrom(ex:la-campagne-de-Russie-1812-1813,
+ex:revue-d-Histoire-de-la-Pharmacie-t-XVIII,
+              [ prov:type='prov:Source' ])
+</pre>
+</div>
+
+
+<div class="anexample" id="anexample-primary-source2">
 <p>
 Let us consider the concept introduced in the current section, identified as <a title="primary source"><span class="name">dm:concept-primary-source</span></a>, and
 the Google page <a href="http://googlenewsblog.blogspot.com/2010/11/credit-where-credit-is-due.html"><span class="name">go:credit-where-credit-is-due.html</span></a>, where the notion original-source was originally described (to the knowledge of the authors).