small edits plus issue Turtle example
authorGuus Schreiber <guus.schreiber@vu.nl>
Wed, 13 Nov 2013 22:49:24 +0100
changeset 1321 efcb10c99180
parent 1320 1d97d46e31b5
child 1322 2bea1763bdcd
small edits plus issue Turtle example
rdf-primer/index.html
--- 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 &lt;http://example.org/&gt; .
 02    @prefix foaf: &lt;http://xmlns.com/foaf/0.1/&gt; .
@@ -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