Added "Contributing" section and did more restructuring.
authorManu Sporny <msporny@digitalbazaar.com>
Fri, 15 Oct 2010 11:18:52 -0400
changeset 9 aa407f36606a
parent 8 b87956df5de8
child 10 31bd06d88c46
Added "Contributing" section and did more restructuring.
spec/latest/index.html
--- a/spec/latest/index.html	Fri Oct 15 10:34:00 2010 -0400
+++ b/spec/latest/index.html	Fri Oct 15 11:18:52 2010 -0400
@@ -258,26 +258,6 @@
 </p>
 </section>
 
-<section>
-<h3>How to Read this Document</h3>
-
-<p>
-This document is a detailed specification for a serialization of JSON for Linked
-data. The document is primarily intended for the following audiences:
-</p>
-
-<ul>
-  <li>Developers that want to encode Microformats, RDFa, or Microdata in a
-  way that is cross-language compatible via JSON.</li>
-  <li>Developers that want to understand the encoding possibilities.</li>
-</ul>
-
-<p>
-To understand this specification you must first be familiar with JSON, 
-which is detailed in [[!RFC4627]].</p>
-
-</section>
-
 <section id='sotd'>
 <p>This document is an experimental work in progress.</p>
 <!-- <p>
@@ -310,10 +290,62 @@
 generate, stream-based and document-based processing compatible, and require
 a tiny memory footprint in order to operate.
 </p>
+
+<section>
+<h2>How to Read this Document</h2>
+
+<p>
+This document is a detailed specification for a serialization of JSON for Linked
+data. The document is primarily intended for the following audiences:
+</p>
+
+<ul>
+  <li>Web developers that want to understand the design decisions and 
+  language syntax for JSON-LD.</li>
+  <li>Software developers that want to encode Microformats, RDFa, or Microdata 
+  in a way that is cross-language compatible via JSON.</li>
+  <li>Software developers that want to write processors for JSON-LD.</li>
+</ul>
+
+<p>
+To understand this specification you must first be familiar with JSON, 
+which is detailed in [[!RFC4627]] and [[!RDF-CONCEPTS]].</p>
 </section>
 
 <section>
-<h1>Design Goals</h1>
+<h2>Contributing</h2>
+
+<p>There are a number of ways that one may participate in the development of
+this specification:</p>
+
+<ul>
+<li>All comments and discussion takes place on the public mailing list:
+<a href="http://groups.google.com/group/json-ld">[email protected]
+</a></li>
+
+<li>Specification bugs and issues should be reported in the 
+<a href="http://github.com/digitalbazaar/json-ld/issues">issue tracker</a>.</li>
+
+<li><a href="http://github.com/digitalbazaar/json-ld">Source code</a> for the 
+specification can be found on Github.</li>
+
+<li>The <a href="http://webchat.freenode.net/?channels=#json-ld">#json-ld</a> 
+IRC channel is available for real-time discussion on irc.freenode.net.</li>
+</ul>
+
+</section>
+
+</section>
+
+<section>
+<h1>Design Goals and Rationale</h1>
+
+<p>The following section outlines the design goals and rationale behind the 
+JSON-LD markup language.
+</p>
+
+<section>
+<h2>Goals</h2>
 
 <p>
 A number of design considerations were explored during the creation of this 
@@ -342,13 +374,6 @@
 </section>
 
 <section>
-<h1>Design Rationale</h1>
-
-<p>The following section outlines the rationale behind the JSON-LD markup
-language.
-</p>
-
-<section>
 <h2>Map Terms to IRIs</h2>
 
 <p>Establishing a mechanism to map JSON values to IRIs will