Clarified the explanation of 'array' based on feedback from Pat Hayes.
authorManu Sporny <msporny@digitalbazaar.com>
Thu, 03 May 2012 23:29:46 -0400
changeset 620 afcd956fd963
parent 619 47c6b95254e4
child 621 f1e5a41d62a0
Clarified the explanation of 'array' based on feedback from Pat Hayes.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Thu May 03 15:35:08 2012 -0400
+++ b/spec/latest/json-ld-syntax/index.html	Thu May 03 23:29:46 2012 -0400
@@ -371,9 +371,12 @@
     </dd>
     <dt><tdef>array</tdef></dt>
     <dd>
-      An array is an ordered collection of values. An array structure is represented as square brackets surrounding zero or more values (or elements). Elements are separated by commas.  Within JSON-LD, array order is not preserved by default, unless
-      specific markup is provided (see <a href="#sets-and-lists">Sets and Lists</a>). This is because the basic data model of JSON-LD
-      is a <tref>linked data graph</tref>, which is inherently unordered.
+      In JSON, an array is an <em>ordered</em> collection of values. An array 
+      is represented as square brackets surrounding zero or more values that
+      are separated by commas.  While JSON-LD uses the same array representation
+      as JSON, the collection is <em>unordered</em> by default. While order is 
+      preserved in regular JSON arrays, it is not in regular JSON-LD arrays 
+      unless specific markup is provided (see <a href="#sets-and-lists">Sets and Lists</a>). 
     </dd>
     <dt><tdef>string</tdef></dt><dd>
       A string is a sequence of zero or more Unicode characters, wrapped in double quotes, using backslash escapes. A