review Markus
authorGuus Schreiber <guus.schreiber@vu.nl>
Mon, 24 Feb 2014 10:21:29 +0100
changeset 2003 89d4996c97d0
parent 2002 8df5f4adf193
child 2004 3052bd90565c
review Markus
rdf-primer/index.html
--- a/rdf-primer/index.html	Fri Feb 21 18:43:55 2014 +0100
+++ b/rdf-primer/index.html	Mon Feb 24 10:21:29 2014 +0100
@@ -172,7 +172,7 @@
       [[RDF11-CONCEPTS]]</li>
       <li>A document describing the formal model-theoretic semantics
       of RDF ("RDF Semantics") [[RDF11-MT]]</li>
-      <li>Specifications of concrete syntaxes for RDF:
+      <li>Specifications of serialization formats for RDF:
         <ul>
 	  <li>Turtle [[TURTLE]] and TriG [[TRIG]]</li>
 	  <li>JSON-LD [[JSON-LD]] (JSON based)</li>
@@ -370,7 +370,7 @@
      <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
+     <code>string</code> was confusing. RDF languages such as Turtle allow
      writing of literals without an explicit datatype and treat this
      as syntactic sugar for a <code>string</code>
      datatype. The special datatype
@@ -653,11 +653,11 @@
 
     <h2>Writing RDF graphs</h2>
 
-    <p>Many different concrete syntaxes exist for writing down RDF
+    <p>A number of different serialization formats exist for writing down RDF
     graphs. However, different ways of writing down the same graph lead
     to exactly the same triples, and are thus logically equivalent. </p>
 
-    <p>In this section we briefly introduce, through annotated examples, the following syntaxes:</p>
+    <p>In this section we briefly introduce, through annotated examples, the following formats:</p>
 <ol>
   <li>Turtle family of RDF languages
     (<a href="#section-n-triples">N-Triples</a>,
@@ -670,14 +670,15 @@
 </ol>
 
 <p class="note">
-Tip: we suggest to read Sec. 5.1 on the Turtle-related syntaxes and to read
-the sections on JSON-LD, RDFa and RDF/XML only when you are
+Reading tip: Sec. 5.1 (Turtle <em>et al.</em>) discusses all
+basic ooncepts for serializing RDF. We suggest you
+read the sections on JSON-LD, RDFa and RDF/XML only if you are
 interested in that particular usage of RDF. </p>
 
 <section id="section-turtle-family">
 <h3>Turtle family of RDF languages</h3>
 
-<p>In this subsection we introduce four concrete syntaxes for RDF
+<p>In this subsection we introduce four RDF languages
 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
@@ -990,7 +991,7 @@
       <code>http://example.org/bob#me</code>, as
       specified on line 3, through the use of the <code>@id</code> keyword.
       The <code>@id</code> keyword, when used as a key in a JSON-LD document, points
-      to an IRI identifying the resource corresponding to the parent JSON object.
+      to an IRI identifying the resource corresponding to the current JSON object.
       We describe the type of this resource on line 4, its birth date
       on line 5 and one of its friends on line 6. From line 7 to 12 we describe 
       one of its interests, the Mona Lisa painting.</p>
@@ -1160,7 +1161,7 @@
 graphs. When RDF was original developed in the late 1990s, this was its 
 only syntax, and some people still call this syntax "RDF". In 2001, a 
 precursor to Turtle called "N3" was proposed, and gradually the other 
-syntaxes listed here have been adopted and standardized. </p>
+languages listed here have been adopted and standardized. </p>
 
 <p>The RDF/XML example below encodes the 
 RDF graph depicted in <a href="#fig4">Fig.&nbsp;4</a>:</p>
@@ -1327,8 +1328,8 @@
 
     <p>RDF allows you to combine triples from any source into a graph
     and process it as legal RDF. A large amount of RDF data is
-    available as part of the Linked 
-    Data [[LINKED-DATA]] cloud. Datasets are being published and
+    available as Linked 
+    Data [[LINKED-DATA]]. Datasets are being published and
     interlinked on the Web using RDF, and many of them offer a
     querying facility through SPARQL [[SPARQL11-OVERVIEW]]. Examples
     of such datasets used in the examples above include:</p>
@@ -1355,7 +1356,7 @@
       libraries and other agencies.</li> 
     </ul>
 
-    <p>A list of datasets available within the Linked Data cloud is maintained at
+    <p>A list of datasets available as Linked Data is maintained at
     <a href="http://datahub.io/dataset">datahub.io</a>.</p>
 
     <P>A number of vocabulary terms have become popular for