Fix some references in API spec and mark introductory sections as non-normative
--- a/spec/latest/json-ld-api/index.html Fri Dec 14 14:07:37 2012 +0100
+++ b/spec/latest/json-ld-api/index.html Fri Dec 14 14:14:04 2012 +0100
@@ -173,7 +173,7 @@
</section>
-<section>
+<section class="informative">
<h2>Introduction</h2>
<p>
@@ -201,22 +201,18 @@
</section>
-<section>
+<section class="informative">
<h1>Features</h1>
-<p>
-The JSON-LD Syntax specification [[!JSON-LD]] outlines a language that may be
-used to express Linked Data in JSON. Often, it is useful to be able to
-transform JSON-LD documents so that they may be easily processed in
-a programming environment like JavaScript, Python or Ruby.
-</p>
+<p>The JSON-LD Syntax specification [[!JSON-LD]] outlines a language that may be
+ used to express Linked Data in JSON. Often, it is useful to be able to transform
+ JSON-LD documents so that they may be easily processed in various programming
+ environments.</p>
-<p>
-There are four major types of transformation that are discussed in this
-document; compaction, expansion, and RDF conversion.
-</p>
+<p>There are three major types of transformation that are discussed in this document:
+ compaction, expansion, and RDF conversion.</p>
-<section>
+<section class="informative">
<h2>Expansion</h2>
<p>Software algorithms are easiest to write when the data that they are processing
have a regular form. Since information can be represented by JSON-LD in a
@@ -268,8 +264,8 @@
performs two important operations. The first is to expand all values that represent
<tref title="IRI">IRIs</tref> to <tref title="absolute IRI">absolute IRIs</tref>.
The second is to express all values in <tref>expanded form</tref>. Running the
- <a href="expansion-algorithm"></a> against the examples provided above results
- in the following output:</p>
+ <a href="#expansion-algorithm">Expansion algorithm</a> against the examples provided
+ above results in the following output:</p>
<pre class="example" data-transform="updateExample">
<!--
@@ -299,7 +295,7 @@
software program to process because of its very regular structure.</p>
</section>
-<section>
+<section class="informative">
<h2>Compaction</h2>
<p>While expansion expands a given input as much as possible, compaction performs
the opposite operation: it expresses a given input as succinctly as possible. In contrast
@@ -349,9 +345,9 @@
-->
</pre>
- <p>Running the <a href="compaction-algorithm"></a> given the context supplied above
- against the JSON-LD input document provided above would result in the following
- output:</p>
+ <p>Running the <a href="#compaction-algorithm">Compaction Algorithm</a> given the context
+ supplied above against the JSON-LD input document provided above would result in the
+ following output:</p>
<pre class="example" data-transform="updateExample">
<!--
@@ -382,7 +378,7 @@
</section>
-<section>
+<section class="informative">
<h2>RDF Conversion</h2>
<p>JSON-LD can be used to serialize data expressed in RDF as described in
[[RDF-CONCEPTS]]. This ensures that data can be round-tripped from and to