--- a/rdf-primer/index.html	Mon Feb 03 15:43:20 2014 +0100
+++ b/rdf-primer/index.html	Mon Feb 03 16:31:52 2014 +0100
@@ -130,8 +130,7 @@
 <section id="section-Introduction">
     <h2>Introduction</h2>
 
-    <p class="note">This primer is an informative document. The
-    purpose is to give a light-weight overview of RDF 1.1.
+    <p class="note">The objective of this document is to give a light-weight overview of RDF 1.1.
     Secs. 3-5 can be used as a minimalist introduction into the key
     elements of RDF. Changes between RDF 1.1
     and RDF 1.0 (2004 version) are summarized in the separate document "What's New in RDF
@@ -324,8 +323,8 @@
 
     <p>IRIs can appear in <strong>all three positions</strong> of a triple. </p>
 
-    <p>IRIs can be used to identify both documents
-    (e.g. a Web page) and things (e.g. a person). 
+    <p>IRIs are used to identify resources such as documents,
+    physical, people, physical objects, and asbttact concepts.  
     For example, the IRI for the "Mona Lisa" painting in
     <a href="http://www.wikidata.org/">Wikidata</a> is:</p>
 
@@ -340,6 +339,13 @@
 
       <div class="example"><a href="http://data.europeana.eu/item/04802/243FA8618938F4117025F17A8B813C5F9AA4D619">http://data.europeana.eu/item/04802/243FA8618938F4117025F17A8B813C5F9AA4D619</a></div>
 
+    <p>IRIs are global identifiers, so other people can re-use this
+    IRI to identify the same thing. For example, the following IRI is
+    used by many people as an RDF property to state a friendship
+    relationship:</p>
+
+    <div class="example"><a href="http://xmlns.com/foaf/0.1/knows">http://xmlns.com/foaf/0.1/knows</a></div>
+      
     <p>RDF is agnostic about what the IRI represents. However,
     IRIs may be given meaning by particular vocabularies or
     conventions. For example, <a
@@ -365,15 +371,15 @@
       be associated with the "fr" language tag and "李奥纳多·达·文西"
       with the "zh" language tag.</p> 
       
-     <p class="note">The RDF data model assigns the special datatype
-     <code>rdf:langString</code> to language-tagged literals.</p>
-      
      <p class="note">The 2004 version of RDF contained the notion of a
      "plain literal" with no datatype. This feature has been removed, as the
      distinction between "plain" literals and literals with datatype
      <code>string</code> was confusing. RDF syntaxes such as Turtle allow
      writing of literals without an explicit datatype and treat this
-     as syntactic sugar for a <code>string</code> datatype.</p> 
+     as syntactic sugar for a <code>string</code>
+     datatype. The special datatype
+     <code>rdf:langString</code> is assigned to language-tagged
+     literals.</p> 
 
      <p>Literals may only appear in the <strong>object position</strong> of a triple.</p>
 
@@ -667,6 +673,8 @@
       end of the triple. This example represents concrete syntax for
       the second triple in <a href="#example-1">Example 1</a>.</p> 
 
+<p class="issue">Should we explitly introduce N-Triples here?</p>
+
       <p>In addition to this basic stntax, Turtle
       introduces a number of syntax shortcuts, such as
       support for namespaces, lists and shorthands for datatyped 
@@ -741,13 +749,7 @@
       <figcaption>Graph of the Turtle example</figcaption>
     </figure>
 
-<p class="issue">TODO: finetune figure details, such as literal values</p>
-
-<P class="note">N-Triples is a line-based subset of Turtle and is a
-useful vehicle to understand how concrete and abstract syntax are related. Check the <a
-href="#subsection-ntriples">N-Triples verion of the example</a>
-to see that each line represents precisely one triple of the graph above. </p> 
-</pre>
+<p class="issue">TODO: fine-tune figure details, such as literal values</p>
 
 <p>In case of language-tagged strings the tag
 appears directly after the string, separated by a <code>@</code>
@@ -942,7 +944,7 @@
     <code>ex:bob rdf:type foaf:Person .</code>
    </pre>
    
-   <p class="note">RDF Semantics distinguishes
+   <p>RDF Semantics distinguishes
    a number of different "entailment regimes". The derivation above is
    an example of an RDF Schema entailment. For detailed
    information about entailment regimes 
@@ -956,7 +958,7 @@
     abide by the constraints defined for the XML Schema datatype <a
     href="http://www.w3.org/TR/xmlschema11-2/#integer">integer</a>.</p>
 
-   <p class="note">RDF tools may not recognize all datatypes. As a
+   <p>RDF tools may not recognize all datatypes. As a
    minimum, tools are required to support the datatypes for string literals
    and language-tagged literals.</p>