Added a warning about the scope of the document.
authorManu Sporny <msporny@digitalbazaar.com>
Sun, 10 Jun 2012 20:45:53 -0400
changeset 699 9306c91d854b
parent 698 0f68bfb53513
child 700 3d62d8ba4408
Added a warning about the scope of the document.
spec/latest/json-ld-api/index.html
--- a/spec/latest/json-ld-api/index.html	Sun Jun 10 20:37:25 2012 -0400
+++ b/spec/latest/json-ld-api/index.html	Sun Jun 10 20:45:53 2012 -0400
@@ -296,6 +296,15 @@
 the expectation that they could be used in a production system within the
 next year.
 </p>
+<p class="issue">
+It is important for readers to understand that the scope of this document is
+currently under debate and new features may be added to the specification. 
+Existing features may be modified heavily or removed entirely from the
+specification upon further review and feedback from the broader community.
+This is a work in progress and publication as a First Public Working Draft
+does not require that all Working Group members agree on the content of the
+document. 
+</p>
 </section>
 
 <section>
@@ -367,7 +376,7 @@
 </p>
 
 <section>
-  <h2><tdef>Expansion</tdef></h2>
+  <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 
@@ -402,11 +411,12 @@
 While both inputs are valid JSON-LD, writing a program to handle every
 permutation of possible inputs can be difficult, especially when the incoming
 context could change as well. To ensure that the data can be given a more
-uniform structure, JSON-LD introduces the notion of <tref>expansion</tref>.
-Expansion performs two important operations. The first is to expand all
-values that are <tref>IRI</tref>s to their fully expanded form. The second
-is to express all values in <tdef>expanded form</tdef>. To transform both
-inputs above to the same representation, the developer could do the following:
+uniform structure, JSON-LD introduces the notion of expansion.
+<tdef>Expansion</tdef> performs two important operations. The first is to 
+expand all values that are <tref>IRI</tref>s to their fully expanded form. 
+The second is to express all values in <tdef>expanded form</tdef>. To 
+transform both inputs above to the same representation, the developer could 
+do the following:
   </p>
 
   <pre class="example" data-transform="updateExample">