--- a/people/index.html Sun Jan 29 12:52:24 2012 +0000
+++ b/people/index.html Sun Jan 29 13:06:27 2012 +0000
@@ -60,7 +60,6 @@
<http://data.sccgov.org/people/björkg> rdf:type foaf:Person ;
foaf:name "Björk Guðmundsdóttir" .
</pre>
-<p class="editorsnote">@@TODO: describe a person's fundamental characteristics (@@TODO: evaluate ISA <a href="http://joinup.ec.europa.eu/asset/core_person/description">Core Person Vocabulary</a>).</p>
<p>How to provide further details about a person, such as an address, is specified in section <a href="#relations-to-contact-info">relating a person to a contact information</a>.
<div class="practice">
<p><span id="sample-practice" class="practicelab">Deriving domain-specific person types</span></p>
@@ -70,13 +69,13 @@
<section>
<h2 id="relations">Relating people</h2>
-<p class="editorsnote">@@TODO: describe in which way people can be related to other entities such as other people, organisations, etc.</p>
+<p>Beyond stating the basic characteristics of a person one can relate a person to a <dfn>target entity</dfn> such as an organisation or project. The following sections normatively specify how to do this. For any target entity type not listed in the below sections one is free to use any appropriate vocabulary. See also the <a href="https://dvcs.w3.org/hg/gld/raw-file/default/bp/index.html#vocabulary-selection---boris">vocabulary selection</a> section of the <em>Best Practices for Publishing Linked Data</em> document for guidance on how to find and select such a vocabulary.</p>
<p class="editorsnote"><a href="https://www.w3.org/2011/gld/track/issues/18">ISSUE-18</a></p>
<section>
<h3 id="relations-to-contact-info">Relating a person to a contact information</h3>
-<p>In order to relate a person to a contact information, such as typically found on a business card, 1. the contact information MUST be represented using <a href="http://www.w3.org/TR/vcard-rdf/" title="Representing vCard Objects in RDF">vCard</a>, and 2. the link type used between a person and a contact information MUST be <code>gldp:card</code>.</p>
-<p class="editorsnote">@@TODO: define a term that relates a person to a vCard object, based on the semantics of <a href="http://open.vocab.org/docs/businessCard" title="ov:businessCard, a property in the OpenVocab RDF schema">ov:businessCard</a>.</p>
+<p>In order to relate a person to a contact information, such as typically found on a business card, 1. the contact information MUST be represented using <a href="http://www.w3.org/TR/vcard-rdf/" title="Representing vCard Objects in RDF">vCard</a>, and 2. the link type used between a person and a contact information MUST be <code><a href="#gldp-terms-card">gldp:card</a></code>.</p>
+<p class="editorsnote">@@TODO: define a term that relates a person to a vCard object, based on the semantics of <code><a href="http://open.vocab.org/docs/businessCard" title="ov:businessCard, a property in the OpenVocab RDF schema">ov:businessCard</a></code>.</p>
<p class="editorsnote"><a href="https://www.w3.org/2011/gld/track/issues/22">ISSUE-22</a></p>
</section>
@@ -128,10 +127,10 @@
<tr><th>Term</th><th>Definition</th></tr>
</thead>
<tbody>
- <tr><td><code>gldp:card</code></td><td>Relates a <code>foaf:Person</code> to a <code>v:VCard</code>; read: <em>a person has a business card</em>.</td></tr>
- <tr><td><code>gldp:ends</code></td><td>Specifies the end date of a <code>foaf:Project</code> as an <code><a href="http://www.w3.org/TR/xmlschema11-2/#dateTime" title="W3C XML Schema Definition Language (XSD) 1.1 Part 2: Datatypes">xsd:dateTime</a></code> [[!XMLSCHEMA2]]; read: <em>a projects ends on date</em>.</td></tr>
- <tr><td><code>gldp:lead</code></td><td>Relates a <code>foaf:Project</code> to a <code>foaf:Person</code>; read: <em>a project has a project lead</em>.</td></tr>
- <tr><td><code>gldp:starts</code></td><td>Specifies the start date of a <code>foaf:Project</code> as an <code><a href="http://www.w3.org/TR/xmlschema11-2/#dateTime" title="W3C XML Schema Definition Language (XSD) 1.1 Part 2: Datatypes">xsd:dateTime</a></code> [[!XMLSCHEMA2]]; read: <em>a projects start on date</em>.</td></tr>
+ <tr id="gldp-terms-card"><td><code>gldp:card</code></td><td>Relates a <code>foaf:Person</code> to a <code>v:VCard</code>; read: <em>a person has a business card</em>.</td></tr>
+ <tr id="gldp-terms-ends"><td><code>gldp:ends</code></td><td>Specifies the end date of a <code>foaf:Project</code> as an <code><a href="http://www.w3.org/TR/xmlschema11-2/#dateTime" title="W3C XML Schema Definition Language (XSD) 1.1 Part 2: Datatypes">xsd:dateTime</a></code> [[!XMLSCHEMA2]]; read: <em>a projects ends on date</em>.</td></tr>
+ <tr id="gldp-terms-lead"><td><code>gldp:lead</code></td><td>Relates a <code>foaf:Project</code> to a <code>foaf:Person</code>; read: <em>a project has a project lead</em>.</td></tr>
+ <tr id="gldp-terms-starts"><td><code>gldp:starts</code></td><td>Specifies the start date of a <code>foaf:Project</code> as an <code><a href="http://www.w3.org/TR/xmlschema11-2/#dateTime" title="W3C XML Schema Definition Language (XSD) 1.1 Part 2: Datatypes">xsd:dateTime</a></code> [[!XMLSCHEMA2]]; read: <em>a projects start on date</em>.</td></tr>
</tbody>
</table>
</section>