--- a/spec/latest/json-ld-syntax/index.html Sun Jan 27 22:21:54 2013 -0500
+++ b/spec/latest/json-ld-syntax/index.html Sun Jan 27 22:52:34 2013 -0500
@@ -2557,17 +2557,21 @@
<tref title="JSON-LD graph">JSON-LD graphs</tref> and comprises exactly one
<tdef>default graph</tdef> and zero or more <tdef title="named graph">named graphs</tdef>.</li>
<li>The default graph does not have a name and MAY be empty.</li>
- <li>Each named graph is a pair consisting of an <tref>IRI</tref> or <tref>blank node</tref>
- (the <tdef>graph name</tdef>) and a <tref>JSON-LD graph</tref>. Whenever possible, the
- <tref>graph name</tref> SHOULD be an <tref>IRI</tref>.</li>
- <li>A <tdef>JSON-LD graph</tdef> is a labeled directed graph, i.e., a set of
- <tref title="node">nodes</tref> connected by <tref title="edge">edges</tref>.</li>
+ <li>Each named graph is a pair consisting of a <tdef>graph name</tdef>
+ and a <tref>JSON-LD graph</tref>. The
+ <tref>graph name</tref> SHOULD be an <tref>IRI</tref> or
+ <tref>blank node identifier</tref>.</li>
+ <li>A <tdef>JSON-LD graph</tdef> is a labeled directed graph containing
+ a set of zero or more <tref title="node">nodes</tref> connected by
+ <tref title="edge">edges</tref>.</li>
<li>Every <tdef>edge</tdef> has a direction associated with it and is labeled with
an <tref>IRI</tref> or a <tref>blank node identifier</tref>. Within the JSON-LD syntax
- these edge labels are called <tdef title="property">properties</tdef>. Whenever possible, an
- <tref>edge</tref> SHOULD be labeled with an <tref>IRI</tref>.</li>
- <li>Every <tdef>node</tdef> is an <tref>IRI</tref>, a <tref>blank node</tref>,
- a <tref>JSON-LD value</tref>, or a <tref>list</tref>.</li>
+ these edge labels are called <tdef title="property">properties</tdef>.</li>
+ <li>Every <tdef>node</tdef> represents a <tdef>resource</tdef> or a
+ <tdef>value</tdef>. <tref title="resource">Resources</tref> are labeled
+ using either an <tref>IRI</tref> or a <tref>blank node identifier</tref>.
+ <tref title="value">Values</tref> are a
+ <tref>JSON-LD value</tref> or a <tref>list</tref>.</li>
<li>A node having an outgoing edge MUST be an <tref>IRI</tref> or a
<tref>blank node</tref>.</li>
<li>A <tref>JSON-LD graph</tref> MUST NOT contain unconnected <tref title="node">nodes</tref>,
@@ -2577,9 +2581,9 @@
defined in [[RFC3987]]. <tref title="IRI">IRIs</tref> used within a
<tref>JSON-LD graph</tref> SHOULD return a <tref>Linked Data</tref> document describing
the resource denoted by that IRI when being dereferenced.</li>
- <li>A <tdef>blank node</tdef> is a <tref>node</tref> which is neither an <tref>IRI</tref>,
- nor a <tref>JSON-LD value</tref>, or a <tref>list</tref>. A blank node MAY be identified
- by a <tref>blank node identifier</tref>.</li>
+ <li>A <tdef>blank node</tdef> is a <tref>resource</tref> which is not
+ labeled with an <tref>IRI</tref>. A blank node MAY be identified
+ using a <tref>blank node identifier</tref>.</li>
<li>A <tdef>blank node identifier</tdef> is a string that can be used as an identifier
for a <tref>blank node</tref> within the scope of a <tref>JSON-LD document</tref>.
Blank node identifiers begin with <code>_:</code>.</li>
@@ -2588,10 +2592,11 @@
<tref>language-tagged string</tref>.</li>
<li>A <tdef>typed value</tdef> consists of a value, which is a string, and a type, which is an IRI.</li>
<li>A <tdef>language-tagged string</tdef> consists of a string and a non-empty language
- tag as defined by [[BCP47]]. The language tag must be well-formed according to section
+ tag as defined by [[BCP47]]. The language tag MUST be well-formed according to section
<a href="http://tools.ietf.org/html/bcp47#section-2.2.9">2.2.9</a> of [[BCP47]], and MUST
- be normalized to lowercase.</li>
- <li>A <tdef>list</tdef> is an ordered sequence of <tref title="IRI">IRIs</tref>,
+ be lowercase.</li>
+ <li>A <tdef>list</tdef> is an ordered sequence of zero or more
+ <tref title="IRI">IRIs</tref>,
<tref title="blank node">blank nodes</tref>, and
<tref title="JSON-LD value">JSON-LD values</tref>.</li>
</ul>