--- a/people/index.html Sun Jan 29 17:35:10 2012 +0000
+++ b/people/index.html Sun Jan 29 20:01:34 2012 +0000
@@ -34,6 +34,8 @@
<section class='informative'>
<h2 id="intro">Introduction</h2>
+<section>
+<h3>Walkthrough example</h3>
<p>In many cases, <dfn title="Data from datastores such as RDBs or spreadsheets that acts as a source for the Linked Data publishing process.">source data</dfn> contains data about people. We will use the following plain text example throughout the document to demonstrate the usage of terms:</p>
<pre class='example sh_html'>
Jane Doe is CEO of ColCids Inc., headquartered in 2242 Old Middlefield Way, Mountain View, CA, United States.
@@ -46,10 +48,26 @@
<p class="editorsnote">@@TODO: link to the definition of source data in the <a href="https://dvcs.w3.org/hg/gld/raw-file/default/bp/index.html">BP document</a></p>
<p>Note: if you're not familiar with people's names throughout the world, you might want to read the <a href="http://www.w3.org/International/questions/qa-personal-names" title="Personal names around the world">personal names around the world</a> article provided by the W3C Internationalization (I18n) Activity.</p>
<div class="fig"><img src="img/people-example.png" alt="GLD people example" /><div>A visual representation of the walkthrough example as a graph (<a href="img/people-example-big.png">big version</a>).</div></div>
-<p>Note that RDF serialisation examples in this document are written in the Turtle [[TURTLE]] syntax.</p>
+</section>
+<section>
+<h3>Conventions</h3>
<p>The key words MUST, MUST NOT, REQUIRED, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL in this specification are to be interpreted as described in RFC 2119 [[!RFC2119]].</p>
+
+<p>Examples of RDF serialisations in this document are written in the Turtle [[TURTLE]] syntax; we assume the following namespace prefix bindings unless otherwise stated:</p>
+<table class="simple" summary="list of prefixes used in the document">
+ <thead>
+ <tr><th>Prefix</th><th>IRI</th></tr>
+ <thead>
+ <tbody>
+ <tr><td><code>rdf:</code></td><td><pre>http://www.w3.org/1999/02/22-rdf-syntax-ns#</pre></td></tr>
+ <tr><td><code>rdfs:</code></td><td><pre>http://www.w3.org/2000/01/rdf-schema#</pre></td></tr>
+ <tr><td><code>xsd:</code></td><td><pre>http://www.w3.org/2001/XMLSchema#</pre></td></tr>
+ </tbody>
+</table>
<p class="editorsnote">@@TODO: define publisher and consumer roles.</p>
</section>
+</section>
+
<section>
<h2 id="characteristics">What is a person?</h2>