Add Conformance section as proposed in #166.
authorFrançois Daoust <francois@joshfire.com>
Sat, 27 Oct 2012 23:12:49 +0200
changeset 946 cd7cb8493e54
parent 923 0e77b0f9445d
child 947 73c9e08b9a62
Add Conformance section as proposed in #166.

The JSON-LD Data Model is now in a proper section, followed by
a terminology section with general terminology and keywords. The
Conformance section (that refers to the notion of JSON-LD graph
defined in the JSON-LD Data Model section) appears next.

No further changes in this commit.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Tue Oct 23 18:59:59 2012 +0200
+++ b/spec/latest/json-ld-syntax/index.html	Sat Oct 27 23:12:49 2012 +0200
@@ -447,10 +447,7 @@
 </section>
 
 <section class="normative">
-<h1>Basic Concepts</h1>
-
-<section>
-<h2>JSON-LD Data Model</h2>
+<h1>JSON-LD Data Model</h1>
 
 <p>JSON-LD is a way of expressing <tref>Linked Data</tref> on the Web. The
   JSON-LD data model encapsulates the following concepts:</p>
@@ -489,6 +486,9 @@
 
 </section>
 
+<section class="normative">
+<h1>Terminology</h1>
+
 <section>
   <h2>General Terminology</h3>
 
@@ -599,6 +599,24 @@
 case-sensitive.</p>
 </section>
 
+</section>
+
+<section class="normative">
+<h1>Conformance</h1>
+
+<p>The JSON-LD Syntax specification describes the conformance criteria for JSON-LD documents (relevant to authors and authoring tool implementors) and processors (relevant to Linked Data tools implementors).</p>
+
+<p>A <tdef>JSON-LD document</tdef> is a JSON document that expresses <tref>Linked Data</tref> in JSON. A JSON-LD document complies with this specification if it follows the normative statements for documents defined in sections <a href="#basic-concepts"></a>, <a href="#advanced-concepts"></a> and <a href="#json-ld-grammar"></a>. For convenience, normative statements for documents are often phrased as statements on the properties of the document.</p>
+
+<p>A <tdef>JSON-LD processor</tdef> parses a <tref>JSON-LD document</tref> and generates the corresponding <tref>JSON-LD graph</tref> (mapping terms to IRIs and coercing values). A JSON-LD processor complies with this specification if it follows the normative statements for processors. Statements that are applicable to a JSON-LD processor are identified in this document by use of the term "JSON-LD processor" in the singular or plural.</p>
+
+<p>The key words MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, NOT RECOMMENDED, MAY, and OPTIONAL in this Recommendation have the meaning defined in [[!RFC2119]].</p>
+
+</section>
+
+<section class="normative">
+<h1>Basic Concepts</h1>
+
 <section>
 <h2>The Context</h2>