Reword introduction of Node Identifiers
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Tue, 12 Mar 2013 19:26:04 +0100
changeset 1428 2aff1ca02a09
parent 1427 5f284949249f
child 1429 a92630f69a94
Reword introduction of Node Identifiers

This addresses #224.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Tue Mar 12 19:11:50 2013 +0100
+++ b/spec/latest/json-ld-syntax/index.html	Tue Mar 12 19:26:04 2013 +0100
@@ -688,21 +688,15 @@
   <h2>Node Identifiers</h2>
 
   <p>To be able to externally reference <tref title="node">nodes</tref>
-    in a <tref title="json-ld graph">graph</tref>, it is important that each <tref>node</tref> has
-    an unambiguous identifier. <tref title="IRI">IRIs</tref> are a fundamental concept of
-    <tref>Linked Data</tref>, and <tref title="node">nodes</tref> should have a de-referenceable
-    identifier used to name and locate them. For <tref title="node">nodes</tref>  to be truly linked,
-    de-referencing the identifier should result in a representation of that <tref>node</tref>.
-    Associating an <tref>IRI</tref> with a <tref>node</tref> tells an application that it
-    can fetch the resource associated with the IRI and get back a description of the
+    in a <tref title="json-ld graph">graph</tref>, it is important that
+    <tref title="node">nodes</tref> have an identifier. <tref title="IRI">IRIs</tref>
+    are a fundamental concept of <tref>Linked Data</tref>, for
+    <tref title="node">nodes</tref> to be truly linked, dereferencing the
+    identifier should result in a representation of that <tref>node</tref>.
+    This may allow an application to retrieve further information about a
     <tref>node</tref>.</p>
 
-  <p><tref title="json-ld document">JSON-LD documents</tref> may also contain descriptions
-    of other <tref title="node">nodes</tref>, so it is necessary to be able to
-    uniquely identify each <tref>node</tref> so that the data is associated
-    with the correct <tref>node</tref> in an unambiguous way.</p>
-
-  <p>A <tref>node</tref> is identified using the <code>@id</code>
+  <p>In JSON-LD, a <tref>node</tref> is identified using the <code>@id</code>
     <tref>keyword</tref>:</p>
 
   <pre class="example" data-transform="updateExample"