--- a/spec/latest/json-ld-syntax/index.html Fri Jun 22 22:31:08 2012 -0400
+++ b/spec/latest/json-ld-syntax/index.html Fri Jun 22 22:38:00 2012 -0400
@@ -436,57 +436,6 @@
</section>
-<section>
- <h2>Syntax Tokens and Keywords</h2>
-
- <p>JSON-LD specifies a number of syntax tokens and <tdef title="keyword">keywords</tdef>
- that are a core part of the language:</p>
-
- <dl>
- <dt><code>@context</code></dt>
- <dd>Used to define the short-hand names that are used throughout a JSON-LD
- document. These short-hand names are called <tref>term</tref>s and help
- developers to express specific identifiers in a compact manner. The
- <code>@context</code> keyword is described in detail in the section titled
- <a href="#the-context">The Context</a>.</dd>
- <dt><code>@graph</code></dt><dd>Used to explicitly label a <tref>linked data graph</tref>.
- This keyword is described in the section titled <a href="#named-graphs">Named Graphs</a>.</dd>
- <dt><code>@id</code></dt>
- <dd>Used to uniquely identify <em>things</em> that are being described in the document.
- This keyword is described in the section titled
- <a href="#identifying-the-subject">Identifying the Subject</a>.</dd>
- <dt><code>@value</code></dt>
- <dd>Used to specify the data that is associated with a particular
- <tref>property</tref> in the graph. This keyword is described
- in the sections titled
- <a href="#string-internationalization">String Internationalization</a> and
- <a href="#typed-values">Typed Values</a>.</dd>
- <dt><code>@language</code></dt>
- <dd>Used to specify the native language for a particular value or the default
- language of a JSON-LD document. This keyword is described in the section titled
- <a href="#string-internationalization">String Internationalization</a>.</dd>
- <dt><code>@type</code></dt>
- <dd>Used to set the data type of a <tref>subject</tref> or
- <tref>typed value</tref>. This keyword is described in the section titled
- <a href="#typed-values">Typed Values</a>.</dd>
- <dt><code>@container</code></dt>
- <dd>Used to set the container of a particular value.
- This keyword is described in the section titled <a href="#sets-and-lists">Sets and Lists</a>.</dd>
- <dt><code>@list</code></dt>
- <dd>Used to express an ordered set of data.
- This keyword is described in the section titled <a href="#sets-and-lists">Sets and Lists</a>.</dd>
- <dt><code>@set</code></dt>
- <dd>Used to express an unordered set of data.
- This keyword is described in the section titled <a href="#sets-and-lists">Sets and Lists</a>.</dd>
- <dt><code>:</code></dt>
- <dd>The separator for JSON keys and values that use
- <tref title="compact_iri">compact IRIs</tref>.</dd>
- </dl>
-
- <p>For the avoidance of doubt, all keys, <tref title="keyword">keywords</tref>, and values in JSON-LD are
- case-sensitive.</p>
-</section>
-
</section>
<section class="informative">
@@ -538,9 +487,11 @@
</dl>
</section>
-<section>
+<section class="normative">
<h1>Basic Concepts</h1>
+<em>This section is normative.</em>
+
<p>JSON-LD is designed to ensure that <tref>Linked Data</tref> concepts can be
marked up in a way that is simple to understand and create by Web authors.
In many cases, regular JSON markup can become Linked Data with the
@@ -609,6 +560,57 @@
</pre>
<section>
+ <h2>Syntax Tokens and Keywords</h2>
+
+ <p>JSON-LD specifies a number of syntax tokens and <tdef title="keyword">keywords</tdef>
+ that are a core part of the language:</p>
+
+ <dl>
+ <dt><code>@context</code></dt>
+ <dd>Used to define the short-hand names that are used throughout a JSON-LD
+ document. These short-hand names are called <tref>term</tref>s and help
+ developers to express specific identifiers in a compact manner. The
+ <code>@context</code> keyword is described in detail in the section titled
+ <a href="#the-context">The Context</a>.</dd>
+ <dt><code>@graph</code></dt><dd>Used to explicitly label a <tref>linked data graph</tref>.
+ This keyword is described in the section titled <a href="#named-graphs">Named Graphs</a>.</dd>
+ <dt><code>@id</code></dt>
+ <dd>Used to uniquely identify <em>things</em> that are being described in the document.
+ This keyword is described in the section titled
+ <a href="#identifying-the-subject">Identifying the Subject</a>.</dd>
+ <dt><code>@value</code></dt>
+ <dd>Used to specify the data that is associated with a particular
+ <tref>property</tref> in the graph. This keyword is described
+ in the sections titled
+ <a href="#string-internationalization">String Internationalization</a> and
+ <a href="#typed-values">Typed Values</a>.</dd>
+ <dt><code>@language</code></dt>
+ <dd>Used to specify the native language for a particular value or the default
+ language of a JSON-LD document. This keyword is described in the section titled
+ <a href="#string-internationalization">String Internationalization</a>.</dd>
+ <dt><code>@type</code></dt>
+ <dd>Used to set the data type of a <tref>subject</tref> or
+ <tref>typed value</tref>. This keyword is described in the section titled
+ <a href="#typed-values">Typed Values</a>.</dd>
+ <dt><code>@container</code></dt>
+ <dd>Used to set the container of a particular value.
+ This keyword is described in the section titled <a href="#sets-and-lists">Sets and Lists</a>.</dd>
+ <dt><code>@list</code></dt>
+ <dd>Used to express an ordered set of data.
+ This keyword is described in the section titled <a href="#sets-and-lists">Sets and Lists</a>.</dd>
+ <dt><code>@set</code></dt>
+ <dd>Used to express an unordered set of data.
+ This keyword is described in the section titled <a href="#sets-and-lists">Sets and Lists</a>.</dd>
+ <dt><code>:</code></dt>
+ <dd>The separator for JSON keys and values that use
+ <tref title="compact_iri">compact IRIs</tref>.</dd>
+ </dl>
+
+ <p>For the avoidance of doubt, all keys, <tref title="keyword">keywords</tref>, and values in JSON-LD are
+ case-sensitive.</p>
+</section>
+
+<section>
<h3>The Context</h3>
<p>In JSON-LD, a <tdef>context</tdef> is used to map <tref>term</tref>s, i.e., properties with associated
@@ -1262,6 +1264,8 @@
<section>
<h1>Advanced Concepts</h1>
+<em>This section is normative.</em>
+
<p>JSON-LD has a number of features that provide functionality above and beyond
the core functionality described above. The following section describes this
advanced functionality in more detail.