--- 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>