Clarify that a term definition must either be a string or an expanded term definition.
authorGregg Kellogg <gregg@kellogg-assoc.com>
Sat, 18 Aug 2012 12:18:08 -0700
changeset 818 9d5e74f76398
parent 817 509cb9f21748
child 819 9b3edb06ea06
Clarify that a term definition must either be a string or an expanded term definition.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Sat Aug 18 12:07:52 2012 -0700
+++ b/spec/latest/json-ld-syntax/index.html	Sat Aug 18 12:18:08 2012 -0700
@@ -2764,15 +2764,15 @@
 <p>If the <tref>context definition</tref> has a <code>@vocab</code> key,
   the value MUST have the lexical form of <tref>absolute IRI</tref> or be <tref>null</tref>.</p>
 <p>Other keys are <tref>term</tref> definitions. Their values MUST be either a
-  <tref>string</tref>, or a <tref>JSON object</tref>. If the value is a
-  <tref>JSON object</tref>, the <tref>term</tref> has an <tdef>expanded term
-  definition</tdef> (see <a href="#expanded-term-definition"></a>)
-  <span class="issue">It is not clear what the last sentence is attempting to convey</span>.</p>
-<p>An <tref>expanded term definition</tref> is composed of zero or more keys from <code>@id</code>,
+  <tref>string</tref>, or a <tref>JSON object</tref> having the form of an <tref>expanded term
+  definition</tref> (see <a href="#expanded-term-definition"></a>).</p>
+<p>An <tdef>expanded term definition</tdef> is composed of zero or more keys from <code>@id</code>,
   <code>@type</code>, <code>@language</code> or <code>@container</code>. An
-  <tref>expanded term definition</tref> MUST NOT contain any other keys.</p>
+  <tref>expanded term definition</tref> MUST NOT contain any other keys.
+  The value of <code>@id</code> MUST expand to an <tref>absolute IRI</tref>.</p>
 <p>If the <tref>term</tref> definition does not have the form of <tref>compact IRI</tref> or <tref>absolute IRI</tref>,
-  the <tref>JSON object</tref> MUST include the <code>@id</code> <tref>keyword</tref>.</p>
+  the <tref>expanded term
+  definition</tref> MUST include the <code>@id</code> key.</p>
 <p>If the <tref>expanded term definition</tref> contains the <code>@id</code> <tref>keyword</tref>,
   it MUST be a <tref>string</tref> having the lexical form of <tref>IRI</tref>,
   <tref>compact IRI</tref>, or a <tref>term</tref> defined in the defining <tref>context