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).
authorGregg Kellogg <gregg@kellogg-assoc.com>
Sun, 24 Jun 2012 17:54:57 -0700
changeset 744 0e29c6d10bc2
parent 743 324f8d7e921a
child 745 96f71de0bd4b
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).
spec/latest/json-ld-syntax/index.html
--- 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">