Updated overview of RDF conversion algorithm to be more precise.
authorManu Sporny <msporny@digitalbazaar.com>
Sun, 10 Jun 2012 23:13:39 -0400
changeset 706 00aba6ceda52
parent 705 97b26a08ac1b
child 707 0ceff46c4040
Updated overview of RDF conversion algorithm to be more precise.
spec/latest/json-ld-api/index.html
--- a/spec/latest/json-ld-api/index.html	Sun Jun 10 22:49:44 2012 -0400
+++ b/spec/latest/json-ld-api/index.html	Sun Jun 10 23:13:39 2012 -0400
@@ -1803,19 +1803,24 @@
     of existing libraries for parsing JSON.
   </p>
   <p>
-    As with other grammars used for describing <tref>Linked Data</tref>, a key concept is that of
-    a <tref>node</tref>. Nodes may be of three basic types: <ldtref>IRI</ldtref>, representing
-    <tref title="IRI">IRIs</tref> for describing
-    externally named entities, <tref>blank node</tref>, resources for which an external name does not
-    exist, or is not known, and <tref>Literal</tref>, which describe terminal entities such as strings,
-    dates and other representations having a lexical form possibly including
-    an explicit language or datatype.
+    As with other grammars used for describing <tref>Linked Data</tref>, a key 
+    concept is that of a <tref>node</tref> in a <tref>linked data graph</tref>. 
+    Nodes may be of three basic types.
+    The first is the <ldtref>IRI</ldtref>, which is used to refer to 
+    <tref>node</tref>s in other <tref>linked data graph</tref>s. 
+    The second is the 
+    <tref>blank node</tref>, which are nodes for which an external name does not
+    exist, or is not known. The third is a <tref>Literal</tref>, which express 
+    values such as strings, dates and other information having a lexical 
+    form, possibly including an explicit language or datatype.
   </p>
-  <p>Data described with JSON-LD may be considered to be the representation of a graph made
-    up of <tref>subject</tref> and <tref>object</tref> <tref title="node">nodes</tref> related via a
-    <tref>property</tref> <tref>node</tref>.
-    However, specific implementations may choose to operate on the document as a normal
-    JSON description of objects having attributes.</p>
+  <p>Data described with JSON-LD may be considered to be a graph made
+    up of <tref>subject</tref> and <tref>object</tref> 
+    <tref title="node">nodes</tref> related via a <tref>property</tref> 
+    <tref>node</tref>. Specific implementations may also choose to operate 
+    on the document as a normal JSON description of objects having 
+    attributes. Both approaches are valid ways to interact with JSON-LD
+    documents.</p>
 </section>
 
 <section>