Finished editing of class/props descriptions and changed new diagram img
authorDaniel Vila <dvila@delicias.dia.fi.upm.es>
Fri, 17 Feb 2012 15:15:50 +0100
changeset 93 25ce68ea3df3
parent 81 e352faad625a
child 94 c662f7efcbea
Finished editing of class/props descriptions and changed new diagram img
org/img/diagram.png
org/index.html
org/respec-config.js
Binary file org/img/diagram.png has changed
--- a/org/index.html	Thu Feb 09 20:44:56 2012 +0100
+++ b/org/index.html	Fri Feb 17 15:15:50 2012 +0100
@@ -94,6 +94,7 @@
     <tr><td>gr</td><td>http://purl.org/goodrelations/v1#</td></tr>  
     <tr><td>opmv</td><td>http://purl.org/net/opmv/ns#</td></tr> 
     <tr><td>org</td><td>http://www.w3.org/ns/org#</td></tr>
+    <tr><td>owlTime</td><td>http://www.w3.org/2006/time#</td></tr>
     <tr><td>skos</td><td>http://www.w3.org/2004/02/skos/core#</td></tr>
     <tr><td>vcard</td><td>http://www.w3.org/2006/vcard/ns#</td></tr>
   </tbody>
@@ -235,7 +236,7 @@
 -->
 </section>
 
-<section>
+<section class="informative">
 <h3>Design notes</h3>
 
   <p>For background to the approach taken in developing the ontology see: 
@@ -244,7 +245,7 @@
 </section>
 
 
-<section>
+<section class="informative">
 <h3>Notes on style</h3>
 
 <p><em>Use of inverses:</em> authorities differ on whether providing pairs of inverse relationships between
@@ -500,7 +501,7 @@
 
 </section> <!-- end of Class OrganizationalUnit-->
 
-<section>
+<section class="informative">
 <h3>Notes on formal organizations</h3>
 <p>Note that the subclass hierarchy
    below <code>org:Organization</code> is not a full covering. There
@@ -517,7 +518,7 @@
    whether this distinction useful in practice.</p>
 </section>
 
-<section>
+<section class="informative">
 <h3>Notes on organizational hierarchy</h3>
 
 <p>In many organizations there is a hierarchy of unit structures. For example we might see a containment hierarchy like:</p>
@@ -533,7 +534,7 @@
 specializing <code>org:hasSubOrganization</code> and/or using <code>owl:allValuesFrom</code> restrictions on the new subclasses.</p>
 </section>
 
-<section>
+<section class="informative">
 <h3>Notes on organizational classification</h3>
 
 <p>In a number of circumstances we wish to classify organizations. There are many approaches that could be 
@@ -561,128 +562,267 @@
 <!--    Reporting relationships and roles   -->
 <section>
 <h3>Reporting relationships and roles</h3>
-<dl>
-<dt><em>Property:</em> <code>org:memberOf</code> (<code>foaf:Agent</code> -&gt; <code>org:Organization</code>)</dt>
-<dd>Indicates that a person 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 is also indended to cover 
-related concepts such as affilliation or other involvement in the 
-organization. Extensions can specialize this relationship to indicate 
-particular roles within the organization or more nuanced relationships 
-to the organization. Has an optional inverse, `org:hasmember`.</dd>
-</dl>
-
-<p> </p>
 
-<dl>
-  <dt><em>Property:</em> <code>org:hasMember</code> (<code>org:Organization</code> -&gt; <code>foaf:Agent</code>, equivalent property to <code>foaf:member</code>)</dt>
-<dd>Indicates a person who is a member of the subject Organization. 
-Inverse of `org:memberOf`, see that property for further clarification. 
-Provided for compatibility with `foaf:member`.</dd>
-</dl>
-
-<p> </p>
 
-<dl>
-<dt><em>Property:</em> <code>org:reportsTo</code> (<code>foaf:Agent</code> -&gt; <code>foaf:Agent</code>)</dt>
-<dd>Indicates a reporting relationship as might be depicted on an 
-organizational chart. The precise semantics of the reporting 
-relationship will vary by organization but is intended to encompass both
- direct supervisory relationships (e.g. carrying objective and salary 
-setting authority) and more general reporting or accountability 
-relationships (e.g. so called <em>dotted line</em> reporting).</dd>
-</dl>
+<!-- Class Membership -->
+<section>
+<h2 id="Class:_Membership">Class: Membership</h2>
+<p>
+Indicates the nature of an Agent's membership of an organization. 
+</p>
+<table class="definition">
+  <thead><tr><th>RDF class:</th><th><a href="http://www.w3.org/ns/org#Membership">org:Membership</a></th></tr></thead>
+  <tbody>
+     <!--tr><td class="prop">subClassOf:</td><td> <a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr-->
+    <tr><td class="prop">Usage note:</td><td> 
 
-<p> </p>
+	Represents an n-ary relation between an Agent, an Organization and a 
+Role. It is possible to directly indicate membership, independent of the
+ specific Role, through use of the <code>org:memberOf</code> property.
+</td></tr>
+</tbody>
+</table>
 
-<dl>
-<dt><em>Class:</em> <code>org:Role</code> subClassOf <code>skos:Concept</code></dt>
-<dd>Denotes a role that a Person or other Agent can take in an 
+
+<!-- Property member -->
+<section>
+<h3 id="Property:_member">Property: member</h3>
+<p>
+	Indicates the Person (or other Agent including Organization) involved in the Membership relationship.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#member">org:member</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Membership">org:Membership</a></td></tr>
+     <tr><td class="prop">Range:</td><td><a href="http://xmlns.com/foaf/0.1/Agent">foaf:Agent</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+     Inverse of <code>org:hasMembership</code>
+</td></tr>
+  </tbody>
+</table>
+</section>
+
+
+
+<!-- Property organization -->
+<section>
+<h3 id="Property:_organization">Property: organization</h3>
+<p>
+	Indicates Organization in which the Agent is a member.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#organization">org:organization</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Membership">org:Membership</a></td></tr>
+     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+  </tbody>
+</table>
+</section>
+
+<!-- Property role -->
+<section>
+<h3 id="Property:_role">Property: role</h3>
+<p>
+	Indicates the Role that the Agent plays in a Membership relationship with an Organization.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#role">org:role</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Membership">org:Membership</a></td></tr>
+     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Role">org:Role</a></td></tr>
+    
+  </tbody>
+</table>
+</section>
+
+<!-- Property hasMembership -->
+<section>
+<h3 id="Property:_hasMembership">Property: hasMembership</h3>
+<p>
+	Indicates a membership relationship that the Agent plays.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#hasMembership">org:hasMembership</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://xmlns.com/foaf/0.1/Agent">foaf:Agent</a></td></tr>
+     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Membership">org:Membership</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+      Inverse of <code>org:member</code>.
+</td></tr>
+  </tbody>
+</table>
+</section>
+
+<!-- Property memberDuring -->
+<section>
+<h3 id="Property:_memberDuring">Property: memberDuring</h3>
+<p>
+	Optional property to indicate the interval for which the membership is/was valid.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#memberDuring">org:memberDuring</a></th></tr></thead>
+  <tbody>
+   
+   
+     <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Membership">org:Membership</a></td></tr>
+      <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2006/time#Interval">owlTime:Interval</a></td></tr>
+    
+  </tbody>
+</table>
+</section>
+
+<!-- Property remuneration -->
+<section>
+<h3 id="Property:_remuneration">Property: remuneration</h3>
+<p>
+	Indicates a salary or other reward associated with the role. 
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#remuneration">org:remuneration	</a></th></tr></thead>
+  <tbody>
+   
+   	
+     <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Membership">org:Membership</a></td></tr>
+     <tr><td class="prop">Usage note:</td><td> 
+    Typically this will be denoted using an existing representation scheme 
+such as <code>gr:PriceSpecification</code> but the range is left open to allow applications to specialize it (e.g. to remunerationInGBP).
+</td></tr> 
+    
+  </tbody>
+</table>
+</section>
+
+
+</section>  <!-- end of Class Membership-->
+
+<!-- Class Role -->
+<section>
+<h2 id="Class:_Role">Class: Role</h2>
+<p>
+Denotes a role that a Person or other Agent can take in an 
 organization. Instances of this class describe the abstract role; to 
 denote a specific instance of a person playing that role in a specific 
-organization use an instance of <code>org:Membership</code>. It is 
+organization use an instance of <code>org:Membership</code>. 
+</p>
+<table class="definition">
+  <thead><tr><th>RDF class:</th><th><a href="http://www.w3.org/ns/org#Role">org:Role</a></th></tr></thead>
+  <tbody>
+     <tr><td class="prop">subClassOf:</td><td> <a href="http://www.w3.org/2004/02/skos/core#Concept">skos:Concept</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+It is 
 common for roles to be arranged in some taxonomic structure and we use 
 SKOS to represent that. The normal SKOS lexical properties should be 
 used when labelling the Role. Additional descriptive properties for the 
-Role, such as a Salary band, may be added by extension vocabularies.</dd>
-</dl>
-
-<p> </p>
-
-<dl>
-<dt><em>Class:</em> <code>org:Membership</code></dt>
-<dd>Indicates the nature of an Agent's membership of an organization. 
-Represents an n-ary relation between an Agent, an Organzation and a 
-Role. It is possible to directly indicate membership, independent of the
- specific Role, through use of the <code>org:memberOf</code> property.</dd>
-</dl>
-
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:member</code> (<code>org:Membership</code> -&gt; <code>foaf:Agent</code>)</dt>
-<dd>Indicates the Person (or other Agent including Organization) involved in the Membership relationship. Inverse of <code>org:hasMembership</code></dd>
-</dl>
-
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:organization</code> (<code>org:Membership</code> -&gt; <code>org:Organization</code>)</dt>
-<dd>Indicates Organization in which the Agent is a member.</dd>
-</dl>
+Role, such as a Salary band, may be added by extension vocabularies.
+</td></tr>
+</tbody>
+</table>
 
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:role</code> (<code>org:Membership</code> -&gt; <code>org:Role</code>)</dt>
-<dd>Indicates the Role that the Agent plays in a Membership relationship with an Organization.</dd>
-</dl>
-
-<p> </p>
+<!-- Property roleProperty -->
+<section>
+<h3 id="Property:_roleProperty">Property: roleProperty</h3>
+<p>
+	This is a metalevel property which is used to annotate an <code>org:Role</code> instance with a sub-property of <code>org:memberOf</code>
+ that can be used to directly indicate the role for easy of query.
+</p>
 
-<dl>
-<dt><em>Property:</em> <code>org:hasMembership</code> (<code>foaf:Agent</code> -&gt; <code>org:Membership</code>)</dt>
-<dd>Indicates a membership relationship that the Agent plays. Inverse of <code>org:member</code>.</dd>
-</dl>
-
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:memberDuring</code> (<code>org:Membership</code> -&gt; <code>owlTime:Interval</code>)</dt>
-<dd>Optional property to indicate the interval for which the membership is/was valid.</dd>
-</dl>
-
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:roleProperty</code> (<code>org:Role</code> -&gt; <code>rdf:Property</code>)</dt>
-<dd>This is a metalevel property which is used to annotate an <code>org:Role</code> instance with a sub-property of <code>org:memberOf</code>
- that can be used to directly indicate the role for easy of query. The 
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#roleProperty">org:roleProperty</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Role">org:Role</a></td></tr>
+    <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/1999/02/22-rdf-syntax-ns#Property">rdf:Property</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+      The 
 intended semantics is a Membership relation involving the Role implies 
 the existence of a direct property relationship through an inference 
-rule of the form:  <code>{ [] org:member ?p; org:organization ?o; org:role [org:roleProperty ?r] } -&gt; {?p ?r ?o}</code>.</dd>
-</dl>
-
-<p> </p>
+rule of the form:  <code>{ [] org:member ?p; org:organization ?o; org:role [org:roleProperty ?r] } -&gt; {?p ?r ?o}</code>
+</td></tr>
+  </tbody>
+</table>
+</section>
 
-<dl>
-<dt><em>Property:</em> <code>org:headOf</code> (<code>foaf:Agent</code> -&gt; <code>org:Organization</code>) subPropertyOf <code>org:memberOf</code></dt>
-<dd>Indicates that a person (or other agent) is the leader or formal 
-head of the Organization. This will normally mean that they are the root
- of the <code>org:reportsTo</code> (acyclic) graph, though an organization may have more than one head.</dd>
-</dl>
+</section>  <!-- end of Class Role-->
 
-<p> </p>
 
-<dl>
-<dt><em>Property:</em> <code>org:remuneration</code> (<code>org:Membership</code> -&gt;)</dt>
-<dd>Indicates a salary or other reward associated with the role. 
-Typically this will be denoted using an existing representation scheme 
-such as <code>gr:PriceSpecification</code> but the range is left open to allow applications to specialize it (e.g. to remunerationInGBP).</dd>
-</dl>
+<!-- Property hasMember -->
+<section>
+<h3 id="Property:_hasMember">Property: hasMember</h3>
+<p>
+	Indicates a person who is a member of the subject Organization. 
+Inverse of `org:memberOf`, see that property for further clarification. 
+</p>
 
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#hasMember">org:hasMember</a></th></tr></thead>
+  <tbody>
+     <tr><td class="prop">Domain:</td><td><a href="http://xmlns.com/foaf/0.1/Agent">foaf:Agent</a></td></tr>
+    <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+     <tr><td class="prop">Equivalent property:</td><td><a href="http://xmlns.com/foaf/0.1/member">foaf:member</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+     Provided for compatibility with `foaf:member`.
+</td></tr>
+  </tbody>
+</table>
+</section>
+
+<!-- Property reportsTo -->
 <section>
+<h3 id="Property:_reportsTo">Property: reportsTo</h3>
+<p>
+	Indicates a reporting relationship as might be depicted on an 
+organizational chart.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#reportsTo">org:reportsTo</a></th></tr></thead>
+  <tbody>
+    <tr><td class="prop">Domain and range:</td><td><a href="http://xmlns.com/foaf/0.1/Agent">foaf:Agent</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+     The precise semantics of the reporting 
+relationship will vary by organization but is intended to encompass both
+ direct supervisory relationships (e.g. carrying objective and salary 
+setting authority) and more general reporting or accountability 
+relationships (e.g. so called <em>dotted line</em> reporting).
+</td></tr>
+  </tbody>
+</table>
+</section>
+
+
+<!-- Property headOf -->
+<section>
+<h3 id="Property:_headOf">Property: headOf</h3>
+<p>
+	Indicates that a person (or other agent) is the leader or formal 
+head of the Organization.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#headOf">org:headOf</a></th></tr></thead>
+  <tbody>
+    <tr><td class="prop">Domain:</td><td><a href="http://xmlns.com/foaf/0.1/Agent">foaf:Agent</a></td></tr>
+     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+      <tr><td class="prop">subPropertyOf:</td><td><a href="http://www.w3.org/ns/org#memberOf">org:memberOf</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+     This will normally mean that they are the root
+ of the <code>org:reportsTo</code> (acyclic) graph, though an organization may have more than one head.
+</td></tr>
+  </tbody>
+</table>
+</section>
+
+<section class="informative">
 <h3>Discussion</h3>
 
 <p>In some applications then it is sufficient to represent the role of an individual
@@ -741,93 +881,199 @@
 <h2>Location</h2>
 
 
-<dl>
-<dt><em>Class:</em> <code>org:Site</code></dt>
-<dd>An office or other premise at which the organization is located. 
+<!-- Class Site -->
+<section>
+<h2 id="Class:_Site">Class: Site</h2>
+<p>
+An office or other premise at which the organization is located. 
 Many organizations are spread across multiple sites and many sites will 
-host multiple locations. In most cases a Site will be a physical 
+host multiple locations. 
+</p>
+<table class="definition">
+  <thead><tr><th>RDF class:</th><th><a href="http://www.w3.org/ns/org#Site">org:Site</a></th></tr></thead>
+  <tbody>
+    
+    <tr><td class="prop">Usage note:</td><td> 
+ In most cases a Site will be a physical 
 location. However, we don't exclude the possibility of non-physical 
 sites such as a virtual office with an associated post box and phone 
 reception service. Extensions may provide subclasses to denote 
-particular types of site.</dd>
-</dl>
-
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:siteAddress</code>  (<code>org:Site</code> -&gt; <code>vcard:VCard</code>)</dt>
-<dd>Indicates a VCard (using the http://www.w3.org/TR/vcard-rdf/ 
-vocabulary) for the site. This can include email, telephone, and 
-geo-location details as well as an address.</dd>
-</dl>
-
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:hasSite</code>  (<code>org:Organization</code> -&gt; <code>org:Site</code>)</dt>
-<dd>Indicates a site at which the Organization has some presence even if
- only indirect (e.g. virtual office or a professional service which is 
-acting as the registered address for a company). Inverse of <code>org:siteOf</code>.</dd>
-</dl>
-
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:siteOf</code>  (<code>org:Site</code> -&gt; <code>org:Organization</code>)</dt>
-<dd>Indicates an Organization which has some presence at the given site. This is the inverse of <code>org:hasSite</code>.</dd>
-</dl>
-
-<p> </p>
+particular types of site.
+</td></tr>
+</tbody>
+</table>
 
-<dl>
-<dt><em>Property:</em> <code>org:hasPrimarySite</code>  (<code>org:Organization</code> -&gt; <code>org:Site</code>) subPropertyOf <code>org:hasSite</code></dt>
-<dd>Indicates a primary site for the Organization, this is the default 
-means by which an Organization can be contacted and is not necessarily 
-the formal headquarters.</dd>
-</dl>
-
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:hasRegisteredSite</code>  (<code>org:FormalOrganization</code> -&gt; <code>org:Site</code>) subPropertyOf <code>org:hasPrimarySite</code></dt>
-<dd>Indicates the legally registered site for the organization, in many 
-legal jurisdictions there is a requirement that FormalOrganizations such
- as Companies or Charities have such a primary designed site.</dd>
-</dl>
+<!-- Property siteAddress -->
+<section>
+<h3 id="Property:_siteAddress">Property: siteAddress</h3>
+<p>
+	Indicates a VCard (using the http://www.w3.org/TR/vcard-rdf/ 
+vocabulary) for the site. This can include email, telephone, and 
+geo-location details as well as an address.
+</p>
 
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:basedAt</code>  (<code>foaf:Person</code> -&gt; <code>org:Site</code>)</dt>
-<dd>Indicates the site at which a person is based. We do not restrict the possibility that a person is based at multiple sites.</dd>
-</dl>
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#siteAddress">org:siteAddress</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Site">org:Site</a></td></tr>
+    <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2006/vcard/ns#VCard">vcard:VCard</a></td></tr>
+    
+  </tbody>
+</table>
+</section>
 
-<p> </p>
+<!-- Property hasSite -->
+<section>
+<h3 id="Property:_hasSite">Property: hasSite</h3>
+<p>
+	Indicates a site at which the Organization has some presence even if
+ only indirect (e.g. virtual office or a professional service which is 
+acting as the registered address for a company).
+</p>
 
-<dl>
-<dt><em>Property:</em> <code>org:location</code>  (<code>foaf:Person</code> -&gt; xsd:string)</dt>
-<dd>Gives a location description for a person within the organization, for example a <em>Mail Stop</em> for internal posting purposes.</dd>
-</dl>
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#hasSite">org:hasSite</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+    <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Site">org:Site</a></td></tr>
+    <tr><td class="prop">inverseOf:</td><td><a href="http://www.w3.org/ns/org#siteOf">org:siteOf</a></td></tr>
+  </tbody>
+</table>
+</section>
 
+<!-- Property siteOf -->
+<section>
+<h3 id="Property:_siteOf">Property: siteOf</h3>
+<p>
+	Indicates an Organization which has some presence at the given site. 
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#siteOf">org:siteOf</a></th></tr></thead>
+  <tbody>
+   
+    
+    <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Site">org:Site</a></td></tr>
+    <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+    <tr><td class="prop">inverseOf:</td><td><a href="http://www.w3.org/ns/org#hasSite">org:hasSite</a></td></tr>
+  </tbody>
+</table>
 </section>
+
+<!-- Property hasPrimarySite -->
+<section>
+<h3 id="Property:_hasPrimarySite">Property: hasPrimarySite</h3>
+<p>
+	Indicates a primary site for the Organization, this is the default 
+means by which an Organization can be contacted and is not necessarily 
+the formal headquarters.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#hasPrimarySite">org:hasPrimarySite</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+    <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Site">org:Site</a></td></tr>
+    <tr><td class="prop">subPropertyOf:</td><td><a href="http://www.w3.org/ns/org#hasSite">org:hasSite</a></td></tr>
+  </tbody>
+</table>
 </section>
 
 
+<!-- Property hasRegisteredSite -->
+<section>
+<h3 id="Property:_hasRegisteredSite">Property: hasRegisteredSite</h3>
+<p>
+	Indicates the legally registered site for the organization, in many 
+legal jurisdictions there is a requirement that FormalOrganizations such
+ as Companies or Charities have such a primary designed site.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#hasRegisteredSite">org:hasRegisteredSite</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+    <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Site">org:Site</a></td></tr>
+    <tr><td class="prop">subPropertyOf:</td><td><a href="http://www.w3.org/ns/org#hasPrimarySite">org:hasPrimarySite</a></td></tr>
+  </tbody>
+</table>
+</section>
+
+<!-- Property basedAt -->
+<section>
+<h3 id="Property:_basedAt">Property: basedAt</h3>
+<p>
+	Indicates the site at which a person is based. We do not restrict the possibility that a person is based at multiple sites.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#basedAt">org:basedAt</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://xmlns.com/foaf/0.1/Person">foaf:Person</a></td></tr>
+    <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Site">org:Site</a></td></tr>
+    <tr><td class="prop">subPropertyOf:</td><td><a href="http://www.w3.org/ns/org#hasPrimarySite">org:hasPrimarySite</a></td></tr>
+  </tbody>
+</table>
+</section>
+</section>  <!-- end of Class Site-->
+
+
+<!-- Property location -->
+<section>
+<h3 id="Property:_location">Property: location</h3>
+<p>
+	Gives a location description for a person within the organization, for example a <em>Mail Stop</em> for internal posting purposes.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#location">org:location</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://xmlns.com/foaf/0.1/Person">foaf:Person</a></td></tr>
+    <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2001/XMLSchema#String">xsd:string</a></td></tr>
+  </tbody>
+</table>
+</section>
+
+</section> <!--   End of LOCATION section -->
+
+
 <!--   Projects and other activities   -->
 <section>
 <h3>Projects and other activities</h3>
+<!-- Class OrganizationalCollaboration -->
+<section>
+	<h2 id="Class:_OrganizationalCollaboration">Class: OrganizationalCollaboration</h2>
+	<p>
+	A collaboration between two or more Organizations such as a project.
+	 It meets the criteria for being an Organization in that it has an 
+	identity and defining purpose independent of its particular members but 
+	is neither a formally recognized legal entity nor a sub-unit within some
+	 larger organization. Might typically have a shorter lifetime than the 
+	Organizations within it, but not necessarily.
+	</p>
+	<table class="definition">
+	  <thead><tr><th>RDF class:</th><th><a href="http://www.w3.org/ns/org#OrganizationalCollaboration">org:OrganizationalCollaboration</a></th></tr></thead>
+	  <tbody>
+	     <tr><td class="prop">subClassOf:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+	    <tr><td class="prop">Usage note:</td><td> 
+	 All members are <code>org:Organization</code>s rather than individuals and those Organizations can play particular roles within the venture. Alternative names: <em>Project</em> <em>Venture</em>  <em>Endeavour</em> <em>Consortium</em>
+	</td></tr>
+	</tbody>
+	</table>
+</section> <!-- End of OrganizationalCollaboration class -->
 
-<dl>
-<dt><em>Class:</em> <code>org:OrganizationalCollaboration</code> (subClassOf  <code>org:Organization</code>)</dt>
-<dd>A collaboration between two or more Organizations such as a project.
- It meets the criteria for being an Organization in that it has an 
-identity and defining purpose independent of its particular members but 
-is neither a formally recognized legal entity nor a sub-unit within some
- larger organization. Might typically have a shorter lifetime than the 
-Organizations within it, but not necessarily. All members are <code>org:Organization</code>s rather than individuals and those Organizations can play particular roles within the venture. Alternative names: <em>Project</em> <em>Venture</em>  <em>Endeavour</em> <em>Consortium</em></dd>
-</dl>
+</section> <!--   End of Projects and other activities   -->
 
-<h2 id="historical">6. Historical information</h2>
+
+<!--   Historical information   -->
+<section>
+<h2>Historical information</h2>
 
 <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. 
@@ -838,56 +1084,125 @@
 The Event mechanism here gives a generic hook for this, building upon the 
 <a href="http://open-biomed.sourceforge.net/opmv/ns">OPMV Provenance Vocabulary</a>.</p>
 
-<dl>
-<dt><em>Class:</em> <code>org:ChangeEvent</code> (subClassOf <code>opmv:Process)</code></dt>
-<dd>Represents an event which resulted in a major change to an 
+<!-- Class ChangeEvent -->
+<section>
+<h2 id="Class:_ChangeEvent">Class: ChangeEvent</h2>
+<p>
+Represents an event which resulted in a major change to an 
 organization such as a merger or complete restructuring. It is intended 
 for situations where the resulting organization is sufficient distinct 
 from the original organizations that it has a distinct identity and 
-distinct URI. Extension vocabularies should define sub-classes of this 
+distinct URI. 
+</p>
+<table class="definition">
+  <thead><tr><th>RDF class:</th><th><a href="http://www.w3.org/ns/org#ChangeEvent">org:ChangeEvent</a></th></tr></thead>
+  <tbody>
+     <tr><td class="prop">subClassOf:</td><td> <a href="http://purl.org/net/opmv/ns#Process">opmv:Process</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+Extension vocabularies should define sub-classes of this 
 to denote particular categories of event. The instant or interval at 
 which the event occurred should be given by `opmv:wasGeneratedAt`, a 
-description should be given by `dct:description`.</dd>
-</dl>
-
-<p> </p>
-
-<dl>
-<dt><em>Property:</em> <code>org:originalOrganization</code> (<code>org:ChangeEvent</code> -&gt; <code>org:Organization</code>) subPropertyOf opmv:used</dt>
-<dd>Indicates one or more organizations that existed before the change 
-event. Depending on the event they may or may not have continued to 
-exist after the event. Inverse of `org:changedBy`. Note that in 
-specializing the OPMV vocabulary we are treating an `org:Organization` 
-as an `opmv:Artifact`, which is consistent with the OPM model.</dd>
-</dl>
-
-<p> </p>
+description should be given by `dct:description`.
+</td></tr>
+</tbody>
+</table>
 
-<dl>
-<dt><em>Property:</em> <code>org:changedBy</code> (<code>org:Organization</code> -&gt; <code>org:ChangeEvent</code>)</dt>
-<dd>Indicates a change event which resulted in a change to this 
-organization. Depending on the event the organization may or may not 
-have continued to exist after the event. Inverse of 
-`org:originalOrganzation`.</dd>
-</dl>
-
-<p> </p>
+<!-- Property originalOrganization -->
+<section>
+<h3 id="Property:_originalOrganization">Property: originalOrganization</h3>
+<p>
+	Indicates one or more organizations that existed before the change 
+event. Depending on the event they may or may not have continued to 
+exist after the event.
+</p>
 
-<dl>
-<dt><em>Property:</em> <code>org:resultedFrom</code> (<code>org:Organization</code> -&gt; <code>org:ChangeEvent</code>) subPropertyOf opmv:wasGeneratedBy</dt>
-<dd>Indicates an event which resulted in (led to, generated) this 
-organization. Inverse of `org:resultingOrganization`. Note that in 
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#originalOrganization">org:originalOrganization</a></th></tr></thead>
+  <tbody>
+   
+    <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#ChangeEvent">org:ChangeEvent</a></td></tr>
+     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+     <tr><td class="prop">inverseOf:</td><td><a href="http://www.w3.org/ns/org#changedBy">org:changedBy</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+      Note that in 
 specializing the OPMV vocabulary we are treating an `org:Organization` 
-as an `opmv:Artifact`, which is consistent with the OPM model.</dd>
-</dl>
-
-<dl>
-<dt><em>Property:</em> <code>org:resultingOrganization</code> (<code>org:ChangeEvent</code> -&gt; <code>org:Organization</code>)</dt>
-<dd>Indicates an organization which was created or changed as a result of the event. Inverse of `org:resultedFrom`.</dd>
-</dl>
+as an `opmv:Artifact`, which is consistent with the OPM model.
+</td></tr>
+  </tbody>
+</table>
 </section>
 
+<!-- Property changedBy -->
+<section>
+<h3 id="Property:_changedBy">Property: changedBy</h3>
+<p>
+Indicates a change event which resulted in a change to this 
+organization. 
+</p>
 
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#changedBy">org:changedBy</a></th></tr></thead>
+  <tbody>
+   
+    
+     <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#ChangeEvent">org:ChangeEvent</a></td></tr>
+     <tr><td class="prop">inverseOf:</td><td><a href="http://www.w3.org/ns/org#originalOrganzation">org:originalOrganzation</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+     Depending on the event the organization may or may not 
+have continued to exist after the event.
+</td></tr>
+  </tbody>
+</table>
+</section>
+
+<!-- Property resultedFrom -->
+<section>
+<h3 id="Property:_resultedFrom">Property: resultedFrom</h3>
+<p>
+Indicates an event which resulted in (led to, generated) this 
+organization.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#resultedFrom">org:resultedFrom</a></th></tr></thead>
+  <tbody>
+   
+    
+     <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#ChangeEvent">org:ChangeEvent</a></td></tr>
+     <tr><td class="prop">subpropertyOf:</td><td><a href="http://purl.org/net/opmv/ns#wasGeneratedBy">opmv:wasGeneratedBy</a></td></tr>
+     <tr><td class="prop">inverseOf:</td><td><a href="http://www.w3.org/ns/org#resultingOrganization">org:resultingOrganization</a></td></tr>
+    <tr><td class="prop">Usage note:</td><td> 
+    Note that in 
+specializing the OPMV vocabulary we are treating an `org:Organization` 
+as an `opmv:Artifact`, which is consistent with the OPM model.
+</td></tr>
+  </tbody>
+</table>
+</section>
+
+<!-- Property resultingOrganization -->
+<section>
+<h3 id="Property:_resultingOrganization">Property: resultingOrganization</h3>
+<p>
+Indicates an organization which was created or changed as a result of the event.
+</p>
+
+<table class="definition">
+  <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/org#resultingOrganization">org:resultingOrganization</a></th></tr></thead>
+  <tbody>
+     <tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/org#ChangeEvent">org:ChangeEvent</a></td></tr>
+     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/org#Organization">org:Organization</a></td></tr>
+     <tr><td class="prop">inverseOf:</td><td><a href="http://www.w3.org/ns/org#resultedFrom">org:resultedFrom</a></td></tr>
+  </tbody>
+</table>
+</section>
+
+</section>  <!-- end of Class Role-->
+
+
+</section>  <!-- end of Section Historical-->
 <!--    ACK   -->
 <section class="appendix">
 
--- a/org/respec-config.js	Thu Feb 09 20:44:56 2012 +0100
+++ b/org/respec-config.js	Fri Feb 17 15:15:50 2012 +0100
@@ -1,7 +1,7 @@
 var respecConfig = {
     // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
     specStatus:           "ED",
-    publishDate:          "2012-02-03",
+    publishDate:          "2012-02-17",
     //copyrightStart:       "2010",
 
     // the specification's short name, as in http://www.w3.org/TR/short-name/