Clarify term and prefix:suffix expansion in the IRIs section.
authorGregg Kellogg <gregg@kellogg-assoc.com>
Sun, 06 Nov 2011 18:53:44 -0800
changeset 256 5a15a47908ae
parent 254 730bd58bef2d
child 257 740c15e6c7ce
Clarify term and prefix:suffix expansion in the IRIs section.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Tue Nov 01 14:32:31 2011 -0400
+++ b/spec/latest/json-ld-syntax/index.html	Sun Nov 06 18:53:44 2011 -0800
@@ -842,12 +842,13 @@
   <li>An <tref>IRI</tref> is generated for the value specified using <code>@type</code>.</li>
   <li>An <tref>IRI</tref> is generated for the value specified using the <code>@iri</code>
     keyword.</li>
-  <li>An <tref>IRI</tref> is generated when there are <code>@coerce</code> rules in
-    effect for a key named <code>@iri</code>.</li>
+  <li>An <tref>IRI</tref> is generated for the value of any other key if there are <code>@coerce</code> rules in
+    effect for that key that identify it as a <code>@iri</code>.</li>
 </ol>
 
-<p>IRIs can be expressed directly in the key position like so:
-</p>
+<p>IRIs may be represented as an absolute IRI, a <tref>term</tref>, a <tref>prefix</tref>:suffix construct, or as a value relative to <code>@base</code> or <code>@vocab</code>.</p>
+
+<p>IRIs can be expressed directly in the key position like so:</p>
 
 <pre class="example" data-transform="updateExample">
 <!--
@@ -863,7 +864,7 @@
 <code>http://xmlns.com/foaf/0.1/name</code> is interpreted as an <tref>IRI</tref>, as
 opposed to being interpreted as a string.</p>
 
-<p>Term expansion occurs for IRIs if a term is defined within the
+<p>Term expansion occurs for IRIs if the value matches a <tref>term</tref> defined within the
 <tref>active context</tref>:</p>
 
 <pre class="example" data-transform="updateExample">
@@ -877,7 +878,8 @@
 -->
 </pre>
 
-<p><tref>Prefix</tref>es are expanded when used in keys:</p>
+<p><tref>Prefix</tref>es are expanded when if the form of the value is <code>prefix:suffix</code>, and the
+  prefix matches a <tref>term</tref> defined within the <tref>active context</tref>:</p>
 
 <pre class="example" data-transform="updateExample">
 <!--
@@ -907,7 +909,7 @@
 </pre>
 
 <p>If type coercion rules are specified in the <code>@context</code> for
-a particular vocabulary term, an IRI is generated:</p>
+a particular <tref>term</tref> or property IRI, an IRI is generated:</p>
 
 <pre class="example" data-transform="updateExample">
 <!--
@@ -931,8 +933,6 @@
 the type coercion rules will transform the value into an IRI when processed
 by a JSON-LD Processor</p>
 
-<p>IRIs may be represented as an absolute IRI, a <tref>term</tref>, a <tref>prefix</tref>:<tref>term</tref> construct, or as a value relative to <code>@base</code> or <code>@vocab</code>.</p>
-
 </section>
 
 <section>