--- a/rdf-primer/index.html	Mon Feb 17 16:01:36 2014 +0000
+++ b/rdf-primer/index.html	Mon Feb 17 17:06:39 2014 +0000
@@ -1361,7 +1361,13 @@
 
 <h3>JSON-LD</h3>
 
-      Single-graph example:
+      <p>In this section we describe several
+      alternative serialisations for JSON-LD, adding to the example
+      in the <a href="#json-ld">JSON-LD section above</a>.</p>
+
+      <p>In the following example we encode the 
+      RDF graph depicted in <a href="#fig4">Fig.&nbsp;4</a>, explicitly
+      encoding IRIs, literal values and datatypes:</p>
 
       <pre class="example" id="json-ld-example-single">
 01    {
@@ -1396,7 +1402,22 @@
 29    }
       </pre>
 
-     <p>Multiple-graphs example:</p>
+     <p>On lines 2 to 10 we define various prefixes that are going to be used in the rest of
+     the document, including FOAF, Dublin Core etc. For example <code>schema:birthDate</code>
+     in this document will be expanded to <code>http://schema.org/birthDate</code>. 
+     We also define a base IRI for that document
+     on line 8, which will be used to resolve all relative IRIs.</p>
+
+     <p>Each object in a JSON-LD document correspond to an RDF resource and 
+     can be associated with its IRI by using an <code>@id</code>
+     attribute, as in lines 11, 18, 21, 23 and 26 in this example.</p>
+
+     <p>Literals with datatypes can be expressed through the <code>@value</code> and <code>@type</code>
+     attributes, as in lines 14 and 15.</p>
+
+     <p>JSON-LD can also be used for RDF datasets, through the use of the <code>@graph</code> keyword. 
+    The example below encodes the
+    RDF dataset depicted in <a href="#fig5">Fig.&nbsp;5</a></p>
 
       <pre class="example" id="json-ld-example-multiple">
 01    {