Update JSON-LD data model to not use subject and object
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Tue, 23 Oct 2012 10:53:29 +0200
changeset 921 67d20a2e3fab
parent 920 41a1daa24321
child 922 b039f0c8f20b
Update JSON-LD data model to not use subject and object

This addresses #47.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Tue Oct 23 00:36:21 2012 +0200
+++ b/spec/latest/json-ld-syntax/index.html	Tue Oct 23 10:53:29 2012 +0200
@@ -456,30 +456,36 @@
   JSON-LD data model encapsulates the following concepts:</p>
 
 <ol>
-  <li>The <tdef>JSON-LD data model</tdef> is used to represent <tref title="JSON-LD graph">JSON-LD graphs</tref>.</li>
-  <li>A <tdef>JSON-LD graph</tdef> is an unordered labeled directed graph, where each <tdef>node</tdef> is a <tref>subject</tref> or <tref>object</tref>, and edges are labeled using <tref title="property">properties</tref>.</li>
-  <li>A <tdef>subject</tdef> is any node in a <tref>JSON-LD graph</tref> with at least one outgoing edge.</li>
-  <li>A <tref>subject</tref> SHOULD be labeled with an <tref><abbr title="Internationalized Resource Identifier">IRI</abbr></tref> (an Internationalized Resource Identifier as described in [[!RFC3987]]).</li>
-  <li>An <tdef>object</tdef> is a node in a <tref>JSON-LD graph</tref> with at least one incoming edge.</li>
-  <li>An <tref>object</tref> MAY be labeled with an <tref>IRI</tref> or a label that is not an <tref>IRI</tref> such as plain text, internationalized text, or a strictly-typed data value.</li>
-  <li>A <tref>node</tref> MAY be a <tref>subject</tref> and an <tref>object</tref> at the same time.</li>
-  <li>A <tdef>property</tdef> is the label on an edge in a <tref>JSON-LD graph</tref>.</li>
-  <li>A <tref>property</tref> SHOULD be an <tref>IRI</tref>.</li>
-  <li>An <tref>IRI</tref> that is a label in a <tref>JSON-LD graph</tref> SHOULD be dereferencable to a <tref>Linked Data</tref> document describing the labeled <tref>subject</tref>, <tref>property</tref> or <tref>object</tref>.</li>
+  <li>The <tdef>JSON-LD data model</tdef> is used to represent
+    <tref title="JSON-LD graph">JSON-LD graphs</tref>.</li>
+  <li>A <tdef>JSON-LD graph</tdef> is an unordered labeled directed graph,
+    where <tdef title="node">nodes</tdef> are <tref title="IRI">IRIs</tref>
+    or <tref title="blank node">Blank Nodes</tref>, or other values.</li>
+  <li>A node having an outgoing edge must be an <tref>IRI</tref> or
+    <tref>Blank Node</tref>.</li>
+  <li>A node having an incoming edge must be an <tref>IRI</tref>,
+    <tref>Blank Node</tref>, or value such as a number or string.</li>
+  <li>A node may have both incoming and outgoing edges.</li>
+  <li>An edge should be labeled with an <tref>IRI</tref>. Within the
+    JSON-LD syntax, this label is called a <tdef>property</tdef>.</li>
+  <li><tref title="IRI">IRIs</tref> used within a <tref>JSON-LD graph</tref>
+    should be dereferenceable to a <tref>Linked Data</tref> document describing
+    the resource denoted by that IRI.</li>
 </ol>
 
-<img style="padding: 5px; border-style: solid; border-width: 1px; display: block; margin-left: auto; margin-right: auto;" src="linked-data-graph.png" title="An example of a JSON-LD graph" longdesc="An example of a JSON-LD graph showing two main nodes labeled with URLs for Alice and Bob. The Alice node contains two other connected nodes showing Alice's age (32) and name (Alice)."/>
-<p style="text-align: center;">
-Figure 1: An example of a JSON-LD graph.
+<p>
+  <img style="padding: 5px; border-style: solid; border-width: 1px; display: block; margin-left: auto; margin-right: auto;"
+  src="linked-data-graph.png" title="An example of a JSON-LD graph"
+  longdesc="An example of a JSON-LD graph showing two main nodes labeled with URLs for Alice and Bob. The Alice node contains two other connected nodes showing Alice's age (32) and name (Alice)."/>
 </p>
+<p style="text-align: center;">Figure 1: An example of a JSON-LD graph.</p>
 <p>There are a number of best practices that can ensure that developers
-will generate good Linked Data for the Web. JSON-LD
-formalizes those techniques by providing a mechanism to map JSON data,
-i.e., keys and values, to <tref>IRI</tref>s. This does not mean
-that JSON-LD requires every key or value to be an IRI, but rather ensures that
-keys and values can be mapped to IRIs if the developer desires to transform
-their data into <tref>Linked Data</tref>.
-</p>
+  will generate good <tref>Linked Data</tref> for the Web. JSON-LD
+  formalizes those techniques by providing a mechanism to map JSON data,
+  i.e., keys and values, to <tref>IRI</tref>s. This does not mean
+  that JSON-LD requires every key or value to be an IRI, but rather ensures that
+  keys and values can be mapped to IRIs if the developer desires to transform
+  their data into <tref>Linked Data</tref>.</p>
 
 </section>