refined intro
authorMichael Hausenblas http://sw-app.org/mic.xhtml#i
Sun, 29 Jan 2012 20:01:34 +0000
changeset 45 6c15228cae51
parent 44 9b68c524d297
child 46 a4f1dd55ffe7
refined intro
people/index.html
--- 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>