Clarified textual description of memberOf and hasMember
authorDave Reynolds <dave@epimorphics.com>
Fri, 06 Dec 2013 22:11:59 +0000
changeset 716 4e41008d5a53
parent 715 5485b8e46e9c
child 717 3f2bf0ce6312
Clarified textual description of memberOf and hasMember
org/index.html
org/static-pr-diff.html
org/static-pr.html
--- a/org/index.html	Fri Dec 06 10:16:27 2013 +0100
+++ b/org/index.html	Fri Dec 06 22:11:59 2013 +0000
@@ -1057,7 +1057,7 @@
 <section>
 <h3 id="org:memberOf">Property: memberOf</h3>
 <p>
-        Indicates that a person is a member of the Organization with no
+        Indicates that an agent (person or other organization) is a member of the Organization with no
 	indication of the nature of that membership or the role
 	played. Note that the choice of property name is not meant to
 	limit the property to only formal membership arrangements, it
@@ -1082,7 +1082,7 @@
 <section>
 <h3 id="org:hasMember">Property: hasMember</h3>
 <p>
-	Indicates a person who is a member of the subject Organization. 
+	Indicates an agent (person or other organization) who is a member of the subject Organization. 
 Inverse of <a href="#org:memberOf">org:memberOf</a>, see that property for further clarification. 
 </p>
 
@@ -1769,6 +1769,7 @@
 <p>Changes since <a href="http://www.w3.org/TR/2013/CR-vocab-org-20130625/">W3C Candidate Recommendation 25 June 2013</a>:</p>
 
 <ul>
+  <li>Clarified textual description of <a href="#org:memberOf">org:memberOf</a> and <a href="#org:hasMember">org:hasMember</a></li>
   <li>Changed reference to Turtle specification to be non-normative, it is only used in non-normative examples.</li>
   <li>Updated the diagram in section 1 to a clearer, more complete version, thanks to João Paulo Almeida.</li>
   <li>Added namespace and links to vocabulary file to the Abstract for ease of reference.</li>
--- a/org/static-pr-diff.html	Fri Dec 06 10:16:27 2013 +0100
+++ b/org/static-pr-diff.html	Fri Dec 06 22:11:59 2013 +0000
@@ -741,12 +741,12 @@
 
 <p>The ontology
   provides <a href="#org:siteAddress">org:siteAddress</a> to define
-  the  <del style="background:#F00">address</del> <del style="background:#F00">of</del> <del style="background:#F00">a</del> <del style="background:#F00">site</del> <del style="background:#F00">using</del> <del style="background:#F00">a</del> <del style="background:#F00">vocabulary</del> <del style="background:#F00">such</del> <del style="background:#F00">as</del> <del style="background:#F00">the</del> <del style="background:#F00">vCard</del> <del style="background:#F00">[</del> <del style="background:#F00">VCARD</del> <del style="background:#F00">]</del> <del style="background:#F00">vocabulary.</del> <del style="background:#F00">2.4</del> <del style="background:#F00">Organizational</del> <del style="background:#F00">history</del> <del style="background:#F00">This</del> <del style="background:#F00">section</del> <del style="background:#F00">is</del> <del style="background:#F00">non-normative.</del> <del style="background:#F00">Note</del> <del style="background:#F00">The</del> <del style="background:#F00">terms</del> <del style="background:#F00">mentioned</del> <del style="background:#F00">in</del> <del style="background:#F00">this</del> <del style="background:#F00">section</del> <del style="background:#F00">are</del> <del style="background:#F00">At</del> <del style="background:#F00">Risk.</del> <del style="background:#F00">The</del> <del style="background:#F00">Working</del> <del style="background:#F00">Group</del> <del style="background:#F00">believes</del> <del style="background:#F00">these</del> <del style="background:#F00">terms</del> <del style="background:#F00">to</del> <del style="background:#F00">be</del> <del style="background:#F00">useful</del> <del style="background:#F00">and</del> <del style="background:#F00">well-founded.</del> <del style="background:#F00">However,</del> <del style="background:#F00">if</del> <del style="background:#F00">insufficient</del> <del style="background:#F00">evidence</del> <del style="background:#F00">of</del> <del style="background:#F00">implementation</del> <del style="background:#F00">can</del> <del style="background:#F00">be</del> <del style="background:#F00">obtained</del> <del style="background:#F00">during</del> <del style="background:#F00">the</del> <del style="background:#F00">Candidate</del> <del style="background:#F00">Recommendation</del> <del style="background:#F00">period</del> <del style="background:#F00">then</del> <del style="background:#F00">the</del> <del style="background:#F00">Working</del> <del style="background:#F00">Group</del> <del style="background:#F00">may</del> <del style="background:#F00">seek</del> <del style="background:#F00">to</del> <del style="background:#F00">advance</del><ins style="background:#0F0">address</ins> <ins style="background:#0F0">of</ins> <ins style="background:#0F0">a</ins> <ins style="background:#0F0">site</ins> <ins style="background:#0F0">using</ins> <ins style="background:#0F0">a</ins> <ins style="background:#0F0">vocabulary</ins> <ins style="background:#0F0">such</ins> <ins style="background:#0F0">as</ins> the  <del style="background:#F00">specification</del> <del style="background:#F00">with</del> <del style="background:#F00">these</del> <del style="background:#F00">terms</del> <del style="background:#F00">omitted.</del><ins style="background:#0F0">vCard</ins> <ins style="background:#0F0">[</ins><cite><a class="bibref" href="#bib-vcard-rdf"><ins style="background:#0F0">vcard-rdf</ins></a></cite><ins style="background:#0F0">]</ins> <ins style="background:#0F0">vocabulary.</ins></p>
+  the address of a site using a vocabulary such as the vCard [<cite><a class="bibref" href="#bib-vcard-rdf"> <del style="background:#F00">VCARD</del><ins style="background:#0F0">vcard-rdf</ins></a></cite>] vocabulary.</p>
 
 </section>
 
 <section id="organizational_history" class="informative" typeof="bibo:Chapter" resource="#ref" rel="bibo:Chapter">
-<h3 aria-level="2" role="heading" id="h3_organizational_history"><span class="secno"><ins style="background:#0F0">2.4</ins> </span><ins style="background:#0F0">Organizational</ins> <ins style="background:#0F0">history</ins></h3><p><em><ins style="background:#0F0">This</ins> <ins style="background:#0F0">section</ins> <ins style="background:#0F0">is</ins> <ins style="background:#0F0">non-normative.</ins></em></p>
+<h3 aria-level="2" role="heading" id="h3_organizational_history"><span class="secno">2.4 </span>Organizational history</h3><p><em>This  <del style="background:#F00">section</del> <del style="background:#F00">is</del> <del style="background:#F00">non-normative.</del> <del style="background:#F00">Note</del> <del style="background:#F00">The</del> <del style="background:#F00">terms</del> <del style="background:#F00">mentioned</del> <del style="background:#F00">in</del> <del style="background:#F00">this</del> <del style="background:#F00">section</del> <del style="background:#F00">are</del> <del style="background:#F00">At</del> <del style="background:#F00">Risk.</del> <del style="background:#F00">The</del> <del style="background:#F00">Working</del> <del style="background:#F00">Group</del> <del style="background:#F00">believes</del> <del style="background:#F00">these</del> <del style="background:#F00">terms</del> <del style="background:#F00">to</del> <del style="background:#F00">be</del> <del style="background:#F00">useful</del> <del style="background:#F00">and</del> <del style="background:#F00">well-founded.</del> <del style="background:#F00">However,</del> <del style="background:#F00">if</del> <del style="background:#F00">insufficient</del> <del style="background:#F00">evidence</del> <del style="background:#F00">of</del> <del style="background:#F00">implementation</del> <del style="background:#F00">can</del> <del style="background:#F00">be</del> <del style="background:#F00">obtained</del> <del style="background:#F00">during</del> <del style="background:#F00">the</del> <del style="background:#F00">Candidate</del> <del style="background:#F00">Recommendation</del> <del style="background:#F00">period</del> <del style="background:#F00">then</del> <del style="background:#F00">the</del> <del style="background:#F00">Working</del> <del style="background:#F00">Group</del> <del style="background:#F00">may</del> <del style="background:#F00">seek</del> <del style="background:#F00">to</del> <del style="background:#F00">advance</del> <del style="background:#F00">the</del> <del style="background:#F00">specification</del> <del style="background:#F00">with</del> <del style="background:#F00">these</del> <del style="background:#F00">terms</del> <del style="background:#F00">omitted.</del><ins style="background:#0F0">section</ins> <ins style="background:#0F0">is</ins> <ins style="background:#0F0">non-normative.</ins></em></p>
 
 <p>Any aspect of organizational structure is subject to change over time. 
 For the most part this should be handled by an external mechanism such as named graphs. 
@@ -1231,7 +1231,7 @@
 <section typeof="bibo:Chapter" resource="#ref" rel="bibo:Chapter" id="property-memberof">
 <h4 id="org:memberOf" aria-level="3" role="heading"><span class="secno">5.3.1 </span>Property: memberOf</h4>
 <p>
-        Indicates that a person is a member of the Organization with no
+        Indicates that  <del style="background:#F00">a</del> <del style="background:#F00">person</del><ins style="background:#0F0">an</ins> <ins style="background:#0F0">agent</ins> <ins style="background:#0F0">(person</ins> <ins style="background:#0F0">or</ins> <ins style="background:#0F0">other</ins> <ins style="background:#0F0">organization)</ins> is a member of the Organization with no
 	indication of the nature of that membership or the role
 	played. Note that the choice of property name is not meant to
 	limit the property to only formal membership arrangements, it
@@ -1256,7 +1256,7 @@
 <section typeof="bibo:Chapter" resource="#ref" rel="bibo:Chapter" id="property-hasmember">
 <h4 id="org:hasMember" aria-level="3" role="heading"><span class="secno">5.3.2 </span>Property: hasMember</h4>
 <p>
-	Indicates a person who is a member of the subject Organization. 
+	Indicates  <del style="background:#F00">a</del> <del style="background:#F00">person</del><ins style="background:#0F0">an</ins> <ins style="background:#0F0">agent</ins> <ins style="background:#0F0">(person</ins> <ins style="background:#0F0">or</ins> <ins style="background:#0F0">other</ins> <ins style="background:#0F0">organization)</ins> who is a member of the subject Organization. 
 Inverse of <a href="#org:memberOf">org:memberOf</a>, see that property for further clarification. 
 </p>
 
@@ -1941,6 +1941,7 @@
 <p>Changes since <a href="http://www.w3.org/TR/2013/CR-vocab-org-20130625/"><abbr title="World Wide Web Consortium">W3C</abbr> <ins style="background:#0F0">Candidate</ins> <ins style="background:#0F0">Recommendation</ins> <ins style="background:#0F0">25</ins> <ins style="background:#0F0">June</ins> <ins style="background:#0F0">2013</ins></a><ins style="background:#0F0">:</ins></p>
 
 <ul>
+  <li><ins style="background:#0F0">Clarified</ins> <ins style="background:#0F0">textual</ins> <ins style="background:#0F0">description</ins> <ins style="background:#0F0">of</ins> <a href="#org:memberOf"><ins style="background:#0F0">org:memberOf</ins></a> <ins style="background:#0F0">and</ins> <a href="#org:hasMember"><ins style="background:#0F0">org:hasMember</ins></a></li>
   <li><ins style="background:#0F0">Changed</ins> <ins style="background:#0F0">reference</ins> <ins style="background:#0F0">to</ins> <ins style="background:#0F0">Turtle</ins> <ins style="background:#0F0">specification</ins> <ins style="background:#0F0">to</ins> <ins style="background:#0F0">be</ins> <ins style="background:#0F0">non-normative,</ins> <ins style="background:#0F0">it</ins> <ins style="background:#0F0">is</ins> <ins style="background:#0F0">only</ins> <ins style="background:#0F0">used</ins> <ins style="background:#0F0">in</ins> <ins style="background:#0F0">non-normative</ins> <ins style="background:#0F0">examples.</ins></li>
   <li><ins style="background:#0F0">Updated</ins> <ins style="background:#0F0">the</ins> <ins style="background:#0F0">diagram</ins> <ins style="background:#0F0">in</ins> <ins style="background:#0F0">section</ins> <ins style="background:#0F0">1</ins> <ins style="background:#0F0">to</ins> <ins style="background:#0F0">a</ins> <ins style="background:#0F0">clearer,</ins> <ins style="background:#0F0">more</ins> <ins style="background:#0F0">complete</ins> <ins style="background:#0F0">version,</ins> <ins style="background:#0F0">thanks</ins> <ins style="background:#0F0">to</ins> <ins style="background:#0F0">João</ins> <ins style="background:#0F0">Paulo</ins> <ins style="background:#0F0">Almeida.</ins></li>
   <li><ins style="background:#0F0">Added</ins> <ins style="background:#0F0">namespace</ins> <ins style="background:#0F0">and</ins> <ins style="background:#0F0">links</ins> <ins style="background:#0F0">to</ins> <ins style="background:#0F0">vocabulary</ins> <ins style="background:#0F0">file</ins> <ins style="background:#0F0">to</ins> <ins style="background:#0F0">the</ins> <ins style="background:#0F0">Abstract</ins> <ins style="background:#0F0">for</ins> <ins style="background:#0F0">ease</ins> <ins style="background:#0F0">of</ins> <ins style="background:#0F0">reference.</ins></li>
--- a/org/static-pr.html	Fri Dec 06 10:16:27 2013 +0100
+++ b/org/static-pr.html	Fri Dec 06 22:11:59 2013 +0000
@@ -1231,7 +1231,7 @@
 <section typeof="bibo:Chapter" resource="#ref" rel="bibo:Chapter" id="property-memberof">
 <h4 id="org:memberOf" aria-level="3" role="heading"><span class="secno">5.3.1 </span>Property: memberOf</h4>
 <p>
-        Indicates that a person is a member of the Organization with no
+        Indicates that an agent (person or other organization) is a member of the Organization with no
 	indication of the nature of that membership or the role
 	played. Note that the choice of property name is not meant to
 	limit the property to only formal membership arrangements, it
@@ -1256,7 +1256,7 @@
 <section typeof="bibo:Chapter" resource="#ref" rel="bibo:Chapter" id="property-hasmember">
 <h4 id="org:hasMember" aria-level="3" role="heading"><span class="secno">5.3.2 </span>Property: hasMember</h4>
 <p>
-	Indicates a person who is a member of the subject Organization. 
+	Indicates an agent (person or other organization) who is a member of the subject Organization. 
 Inverse of <a href="#org:memberOf">org:memberOf</a>, see that property for further clarification. 
 </p>
 
@@ -1941,6 +1941,7 @@
 <p>Changes since <a href="http://www.w3.org/TR/2013/CR-vocab-org-20130625/"><abbr title="World Wide Web Consortium">W3C</abbr> Candidate Recommendation 25 June 2013</a>:</p>
 
 <ul>
+  <li>Clarified textual description of <a href="#org:memberOf">org:memberOf</a> and <a href="#org:hasMember">org:hasMember</a></li>
   <li>Changed reference to Turtle specification to be non-normative, it is only used in non-normative examples.</li>
   <li>Updated the diagram in section 1 to a clearer, more complete version, thanks to João Paulo Almeida.</li>
   <li>Added namespace and links to vocabulary file to the Abstract for ease of reference.</li>