Dropped the "RDF/JSON-LD" list example as it is really confusing and could lead to the impression that the @first and @rest keywords are predefined in the JSON-LD syntax.
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Mon, 24 Oct 2011 15:16:52 +0800
changeset 243 12043ab916ff
parent 242 b68d1dc7dbef
child 244 5936e137987d
Dropped the "RDF/JSON-LD" list example as it is really confusing and could lead to the impression that the @first and @rest keywords are predefined in the JSON-LD syntax.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Mon Oct 24 15:06:25 2011 +0800
+++ b/spec/latest/json-ld-syntax/index.html	Mon Oct 24 15:16:52 2011 +0800
@@ -1241,7 +1241,7 @@
 <section>
   <h2>Lists</h2>
   <p>
-    Because graphs do not describe ordering for links between nodes,  in contrast to plain JSON, multi-valued properties
+    Because graphs do not describe ordering for links between nodes, in contrast to plain JSON, multi-valued properties
     in JSON-LD do not provide an ordering of the listed objects. For example, consider the following
     simple document:
   </p>
@@ -1258,35 +1258,10 @@
   <p>
     This results in three triples being generated, each relating the subject to an individual
     object, with no inherent order.</p>
-  <p>To preserve the order of the objects, RDF-based languages, such as [[TURTLE]]
-    use the concept of an <code>rdf:List</code> (as described in [[RDF-SCHEMA]]). This uses a sequence
-    of unlabeled nodes with properties describing a value, a null-terminated next property. Without
-    specific syntactical support, this could be represented in JSON-LD as follows:
-  </p>
-  <pre class="example" data-transform="updateExample">
-  <!--
-  {
-  ...
-    "@subject": "http://example.org/people#joebob",
-    "nick": ****{****,
-      ****"@first": "joe"****,
-      ****"@rest": {****
-        ****"@first": "bob"****,
-        ****"@rest": {****
-          ****"@first": "jaybee"****,
-          ****"@rest": "@nil"****
-          ****}****
-        ****}****
-      ****}****
-    ****}****,
-  ...
-  }
-  -->
-  </pre>
   <p>
-    As this notation is rather unwieldy and the notion of ordered collections is rather important
-    in data modeling, it is useful to have specific language support. In JSON-LD, a list may
-    be represented using the <code>@list</code> keyword as follows:
+    As the notion of ordered collections is rather important in data modeling, it is useful to 
+    have specific language support. In JSON-LD, a list may be represented using the
+    <code>@list</code> keyword as follows:
   </p>
   <pre class="example" data-transform="updateExample">
   <!--