--- a/rdf-primer/index.html Wed Nov 13 08:48:37 2013 -0800
+++ b/rdf-primer/index.html Wed Nov 13 22:49:24 2013 +0100
@@ -590,6 +590,14 @@
<a href="#subsection-triple">first example</a> can be
represented in Turtle as follows:</p>
+ <p class="issue">In the code below prefixes are used. One commenter
+ has said that the example would have been clearer if the
+ unabbreviated IRI had been used in the triple (here is the
+ comment wich includes <a
+ href="http://lists.w3.org/Archives/Public/public-rdf-wg/2013Nov/0062.html">alternative
+ code</a>). We welcome the
+ view of other readers on this.</p>
+
<pre class="example" id="turtle-example">
01 @base <http://example.org/> .
02 @prefix foaf: <http://xmlns.com/foaf/0.1/> .
@@ -619,7 +627,7 @@
writing down IRIs. A URI like <code>http://xmlns.com/foaf/0.1/</code>
is colloquially called a namespace URI, in this case of the FOAF
vocabulary. The "base" prefix is used if no prefix is provided
-(see <code>bob#me</code>on line 8). A period is used to signal the end
+(see <code>bob#me</code> on line 8). A period is used to signal the end
of a Turtle statement. </p>
<p>Lines 8-12 show how Turtle provides a shorthand for a set of
@@ -629,7 +637,7 @@
set is not yet complete. The triple represented by line 10 looks in
its expanded form like this:</p>
<pre>
-http://example.org/bob#me http://xmlns.com/foaf/0.1/knows http://example.org/alice#me .
+<code>http://example.org/bob#me http://xmlns.com/foaf/0.1/knows http://example.org/alice#me .</code>
</pre>
<p>Line 9 shows an example of a special kind of syntactic sugar. The
@@ -640,9 +648,9 @@
intuition about <code>rdf:type</code>. <p>
<p>In line 11 we see an example of a literal, in this case a date. The
-datatype is appended to the literal through a "^^" delimiter. The date
+datatype is appended to the literal through a <code>^^</code> delimiter. The date
representation follows the conventions of the XML Schema datatype
-"date".</>
+<code>date</code>.</>
<p>Because string literals are so ubiquitous Turtle allows the user to
omit the datatype when writing a string literal. Thus, <code>"This is a
@@ -650,12 +658,12 @@
string"^^xsd:string</code>. </p>
<p>Strings can be language-tagged; the tag
-appears directly after the string, separated by a "@" symbol. In the
+appears directly after the string, separated by a <code>@</code> symbol. In the
case of language-tagged strings no datatype is specifed explictly.
<p class="note">The RDF data model assigns the datatype <code>rdf:langString</code>
to language-typed literals, but in the Turtle syntax this datatype is
-implicit. </p>
+implicit.</p>
<p>The above is by no means a full account of the Turtle syntax. For
more details about the syntax of Turtle the reader is referred to the