Clarify that an unlabeled node is not a subject definition without an @id, but a subject definition which defines the properties of an unlabeled node. (Relates to #135).
--- a/spec/latest/json-ld-syntax/index.html Sun Jun 24 16:56:32 2012 -0700
+++ b/spec/latest/json-ld-syntax/index.html Sun Jun 24 17:54:57 2012 -0700
@@ -521,8 +521,8 @@
transformed to RDF.</p>
<p>Note that the definition for <tref>Linked Data</tref> above is silent on the
-topic of unlabeled nodes. Nevertheless, this specification allows for the expression
-of unlabeled nodes, as most graph-based data sets on the Web contain a number
+topic of <tref title="unlabeled node">unlabeled nodes</tref>. Nevertheless, this specification allows for the expression
+of <tref title="unlabeled node">unlabeled nodes</tref>, as most graph-based data sets on the Web contain a number
of associated nodes that are not named and thus are not directly
de-referenceable.
</p>
@@ -772,7 +772,7 @@
<p>If a set of <tref>term</tref>s such as, <strong>name</strong>,
<strong>homepage</strong>, and <strong>depiction</strong>,
are defined in a <tref>context</tref>, and that context is used to resolve the
-names in JSON objects, machines are able to automatically expand the terms to
+names in <tref title="JSON object">JSON objects</tref>, machines are able to automatically expand the terms to
something meaningful and unambiguous, like this:</p>
<pre class="example" data-transform="updateExample">
@@ -790,7 +790,7 @@
<p class="note">The example above does not use the <code>@id</code> <tref>keyword</tref>
to set the <tref>subject</tref> of the node being described above. This type
-of node is called an <tdef>unlabeled node</tdef>. It is advised that all nodes
+of node is called an <tref>unlabeled node</tref>. It is advised that all nodes
described in JSON-LD are given unique identifiers via the
<code>@id</code> keyword unless the data is not intended to be linked to
from other data sets.</p>
@@ -799,7 +799,7 @@
<tref>subject definition</tref>. <tref title="subject definition">Subject definitions</tref>
do not require an <code>@id</code>.
<tref title="subject definition">Subject definitions</tref> that do not
- contain an <code>@id</code> are known as an <tref>unlabeled node</tref>.</p>
+ contain an <code>@id</code> are known as an <tref title="unlabeled node">unlabeled nodes</tref>.</p>
</section>
</section>
@@ -965,7 +965,7 @@
uniquely identify each node which may be externally referenced.
</p>
<p>A <tref>subject</tref>
- of a JSON object is declared using the <code>@id</code> key. The subject is the
+ of a <tref>JSON object</tref> is a node identified using the <code>@id</code> key. The subject is the
first piece of information needed by the JSON-LD processor in order to
create the (subject, property, object) tuple, also known as a triple.</p>
@@ -987,7 +987,7 @@
<tref>subject definition</tref>. <tref title="subject definition">Subject definitions</tref>
do not require an <code>@id</code>. A
<tref>subject definition</tref>
- that does not contain an <code>@id</code> property is called an
+ that does not contain an <code>@id</code> property defines properties of an
<tref>unlabeled node</tref>.</p>
<p class="note">To ensure the best possible performance, when possible, it is a best practice
@@ -2112,10 +2112,11 @@
<p>At times, it becomes necessary to be able to express information without
being able to specify the subject. Typically, this type of node is called
-an <tref>unlabeled node</tref> or a blank node. In JSON-LD, <tref>unlabeled node</tref> identifiers are
+an <tdef>unlabeled node</tdef> or a blank node (see [[!RDF-CONCEPTS]] <cite><a href="http://www.w3.org/TR/rdf11-concepts/#section-blank-nodes">Section 3.4: Blank Nodes</cite>).
+In JSON-LD, <tref>unlabeled node</tref> identifiers are
automatically created if a subject is not specified using the
<code>@id</code> <tref>keyword</tref>. However, authors may provide identifiers for
-unlabeled nodes by using the special <code>_</code> (underscore)
+<tref title="unlabeled node">unlabeled nodes</tref> by using the special <code>_</code> (underscore)
<tref>prefix</tref>. This allows one to reference the node locally within the
document, but makes it impossible to reference the node from an
external document. The <tref>unlabeled node</tref> identifier is scoped to the
@@ -2459,7 +2460,7 @@
<section>
<h4>Embedding</h4>
<p>Both Turtle and JSON-LD allow embedding of objects, although Turtle only allows embedding of objects which
- use unlabeled node identifiers.</p>
+ use <tref>unlabeled node</tref> identifiers.</p>
</section>
<pre class="example" data-transform="updateExample">