Fix some references in API spec and mark introductory sections as non-normative
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Fri, 14 Dec 2012 14:14:04 +0100
changeset 1041 239469df2bfb
parent 1040 312b93279224
child 1042 8b32dbc56f85
Fix some references in API spec and mark introductory sections as non-normative
spec/latest/json-ld-api/index.html
--- 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