Added a warning about the scope of the document.
--- 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">