Requirements update from telecon.
authorGregg Kellogg <gregg@kellogg-assoc.com>
Tue, 09 Aug 2011 09:19:33 -0700
changeset 142 e6a011087404
parent 141 18819e8ce8f5
child 143 72af67dd9514
Requirements update from telecon.
requirements/latest/index.html
--- a/requirements/latest/index.html	Mon Aug 08 16:20:13 2011 -0400
+++ b/requirements/latest/index.html	Tue Aug 09 09:19:33 2011 -0700
@@ -317,9 +317,10 @@
     <p>The following are taken to be requirements and principles for creating <tref>Linked Data</tref> in JSON.</p>
     <ol>
       <li>A JSON-LD document MUST be able to express a <tref>linked data graph</tref>.</li>
+      <li>A JSON-LD document MUST be a valid JSON document.</li>
       <li>
-        A JSON-LD document uses <trefs>JSON object</trefs>s, arrays, numbers, strings and
-        other literal names to express semantic information.
+        All JSON constructs MUST have semantic meaning in a JSON-LD document: associative arrays, arrays, numbers,
+        strings and other literal names to express semantic information.
       </li>
       <li>A <tref>subject</tref> is defined using a designated name/value pair of a <tref>JSON object</tref>.</li>
       <li>There MUST be a way label a <tref>JSON object</tref> with an IRI.</li>
@@ -331,11 +332,15 @@
         <trefs>JSON object</trefs>s, arrays, numbers, strings and literal names resolve to nodes in
         a <tref>linked data graph</tref>.
       </li>
-      <li>Uncoerced JSON strings represent literal <tref>object</tref>s.</li>
+      <li>Un-coerced JSON strings represent literal <tref>object</tref>s.</li>
       <li>Coerced JSON strings MAY represent IRIs.</li>
       <li>There SHOULD be a way to associate a datatype IRI with a literal JSON value.</li>
       <li>JSON booleans, numbers and other literal values MUST represent specific datatyped literals.
-        <span class="issue">what does null map to?</span></li>
+        <span class="issue">
+          What does null map to? There may be value in specifically saying that
+          the meaning is undefined.
+        </span>
+      </li>
       <li>A JSON array MAY be used to associate multiple <tref>object</tref>s with a <tref>subject</tref> through a common <tref>property</tref>.</li>
       <li>A JSON array MUST NOT be used to imply an order to the component entities.</li>
       <li>A JSON-LD document SHOULD be able to express and ordered list objects.</li>