--- a/rdf-primer/index.html	Tue Feb 18 01:19:33 2014 +0100
+++ b/rdf-primer/index.html	Tue Feb 18 02:06:37 2014 +0100
@@ -667,29 +667,34 @@
     to exactly the same triples, and are thus logically equivalent. </p>
 
     <p>In this section we introduce the Turtle family of RDF languages
-    (Turtle/N-Triples and TriG/N-Quads) and the JSON-based RDF syntax
-    JSON-LD. Two other RDF syntaxes, RDFa (for HTML and XML embedding)
-    and RDF/XML, are briefly described next two 
-    subsections we show RDF syntax examples using the Turtle and Trig
-    language, because these two languages are best suited for human
-    consumption. The final subsection lists the other RDF syntaxes,
-    which include RDFa, JSON-LD (JSON-based syntax),
-    N-Triples/N-Quads (line-based exchange formats) and RDF/XML. In
-    <a href="#section-other-syntaxes">Appendix C</a> the
-    reader can find, for each RDF syntax,
-    corresponding examples of the ones in this section. </p>
+    (<a href="#section-n-triples">N-Triples</a>,
+     <a href="#section-turtle">Turtle</a>,
+     <a href="#section-trig">TriG</a> and
+     <a href="#section-n-quads">N-Quads</a>)
+     and the JSON-based RDF syntax <a href="#section-json-ld">JSON-LD</a>.
+    Two other RDF syntaxes,
+    <a href="#appendix-rdfa">RDFa</a> (for HTML and XML embedding)
+    and <a href="#appendix-rdfxml">RDF/XML</a>, are briefly described later on. </p>
 
 <section>
-<h3>The Turtle family of RDF languages</h3>
+<h3>Turtle family of RDF languages</h3>
+
+<p>In this subsection we introduce four concrete syntaxes for RDF
+which are closely related. We start with N-Triples, as it provides
+basic syntax for writing down RDF triples. The Turtle syntax
+extends this basic syntax with various forms of syntactic sugar to improve
+readability. Subsequently we discuss TriG and N-Quads, which are extensions of Turtle
+respectively N-Triples to encode multiple graphs. Together, these four are
+referred to as the "Turtle family of RDF languages".
 
 <section id="section-n-triples">
 
 <h4>N-Triples</h4>
 
-<p>N-Triples [[N-TRIPLES]]  provides a simple line-based, plain text way for serializing RDF
-graphs. Each line represents an RDF triple. Our 
-<a href="#example-1">first example</a> (in slightly
-extended form) can be represented in N-Triples as follows:</p> 
+<p>N-Triples [[N-TRIPLES]]  provides a simple line-based, plain-text way for serializing RDF
+graphs. Each line represents an RDF triple. The informal graph in <a
+href"#fig1">Fig.&nbsp; 1</a> can be represented in N-Triples in the
+following way:</p> 
 
 <pre class="example" id="n-triples-example">
 01    &lt;http://example.org/bob#me&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://xmlns.com/foaf/0.1/Person&gt; .
@@ -750,7 +755,7 @@
 support for namespaces, lists and shorthands for datatyped 
 literals. Turtle provides a trade-off between ease of
 writing, ease of parsing and readability. The graph shown in
-<a href="#fig4">Fig.&nbsp;</a> can be
+<a href="#fig4">Fig.&nbsp;4</a> can be
 represented in Turtle as follows:</p>
 
       <pre class="example" id="turtle-example">
@@ -775,7 +780,7 @@
 19        dcterms:subject wd:Q12418 .
 </pre>
 
-<p>The Turtle example is logically equivalent to the <a href="n-triples-example">N-Triples</a>
+<p>The Turtle example is logically equivalent to the <a href="#n-triples-example">N-Triples</a>
 example. Lines 1-6 contain a number of directives which provide shorthands for
 writing down IRIs. Relative IRIs (such as <code>bob#me</code> on line 8) are 
 resolved agains a base IRI, specified here in line 1.
@@ -815,7 +820,9 @@
 
 <p>The term <code>_:x</code> is a blank node. It represents an
 unnamed resource depicted in 
-the Mona Lisa painting; the unnamed resource is an instance of the <code>Cypress</code> class. </p>
+the Mona Lisa painting; the unnamed resource is an instance of the
+<code>Cypress</code> class. The example above provides concrete syntax
+for the informal graph in <a href="#fig2">Fig.&nbsp;2</a>.</p>
 
 <p>The above is by no means a full account of the Turtle syntax. For
 more details about the syntax of Turtle please consult the Turtle specification [[TURTLE]].</p>
@@ -829,7 +836,7 @@
 <p>The syntax of Turtle supports only the specification of single
 graphs without a means for "naming" them. TriG [[TRIG]] is an
 <strong>extension of Turtle</strong> enabling the specification of
-multiple graphs.</p>
+multiple graphs in the form of an RDF dataset.</p>
 
 <p class="note">In RDF 1.1 any legal Turtle document is a legal TriG
 document. One could view it as one language. The names Turtle and TriG
@@ -875,7 +882,7 @@
     placed in between matching curly braces (lines 9 &amp; 15, 18 &amp;
     28). Optionally you can precede the graph name with the keyword
     <code>GRAPH</code>. This may improve readability, but it is mainly
-    introduced for alignment with SPARQL Update [[SPARQL11-OVERVIEW]]. </p>
+    introduced for alignment with SPARQL Update [[SPARQL11-UPDATE]]. </p>
 
     <p>The syntax of the triples and of the directives at the top conforms to
     the Turtle syntax.</p>
@@ -915,7 +922,7 @@
 </pre>
 
 <p>The nine lines in the N-Quads example correspond to the nine 
-arcs in <a href="#fig5>Fig.&nbsp;5</a>. Lines 1-7 represent quads, where the first
+arcs in <a href="#fig5">Fig.&nbsp;5</a>. Lines 1-7 represent quads, where the first
 element constitutes the graph IRI. The part of the quad after the
 graph IRI specifies the
 subject, predicate and object of the statement, following the syntactic
@@ -930,7 +937,7 @@
 </section>
 </section>
 
-<section>
+<section id="section-json-ld">
 <h3>JSON-LD</h3>
 
       <p>JSON-LD [[JSON-LD]]  
@@ -1228,6 +1235,8 @@
 <section id="appendix-rdfa"> 
 <h3>RDFa</h3>
 
+  <p class="issue">Include comments/suggestions from Ivan</p>
+  
 <p>RDFa is an RDF syntax for encoding RDF
 triples in an HTML document. The HTML example below encodes the
 RDF graph depicted in <a href="#fig4">Fig.&nbsp;4</a>:</p>