Renamed "stream-based processing" to "one-pass conversion to RDF" to reflect what is meant. Added notes about the best practice to put @context and @subject at the top.
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Wed, 05 Oct 2011 17:52:13 +0200
changeset 212 4b5eca1b60d3
parent 211 13d034c90841
child 213 3f3c47b2816d
Renamed "stream-based processing" to "one-pass conversion to RDF" to reflect what is meant. Added notes about the best practice to put @context and @subject at the top.
spec/latest/index.html
--- a/spec/latest/index.html	Wed Oct 05 17:18:21 2011 +0200
+++ b/spec/latest/index.html	Wed Oct 05 17:52:13 2011 +0200
@@ -319,8 +319,8 @@
 out-of-band. The syntax is designed to not disturb already deployed systems
 running on JSON, but provide a smooth upgrade path from JSON to JSON with
 added semantics. Finally, the format is intended to be easy to parse, efficient to
-generate, stream-based and document-based processing compatible, and require
-a very small memory footprint in order to operate.
+generate, convertible to RDF in one pass, and require a very small memory footprint
+in order to operate.
 </p>
 
 <section>
@@ -469,8 +469,8 @@
  and support a simplified syntax instead. So, while Zero Edits is a goal,
  it is not always possible without adding great complexity to the language.
  </dd>
- <dt>Streaming</dt>
- <dd>The format supports both document-based and stream-based processing.</dd>
+ <dt>One-pass Conversion to RDF</dt>
+ <dd>JSON-LD supports one-pass conversion to RDF with a very small memory footprint.</dd>
 </dl>
 </section>
 
@@ -658,6 +658,11 @@
 <tref>prefix</tref>es that can be used to expand JSON keys and values into
 <tref>IRI</tref>s.</p>
 
+<p class="note">To ensure the best possible performance, it is a best practice to
+put the context definition at the top of the JSON-LD document. If it isn't listed
+first, processors have to save each key-value pair until the context is processed.
+This creates a memory and complexity burden for one-pass processors.</p>
+
 </section>
 
 <section>
@@ -841,6 +846,12 @@
 <code>http://example.org/people#joebob</code>.
 </p>
 
+<p class="note">To ensure the best possible performance, it is a best practice to
+put the <code>@subject</code> key before other key-value pairs in an object. If
+it isn't listed first, processors have to save each key-value pair until
+<code>@subject</code> is processed before they can create valid triples. This
+creates a memory and complexity burden for one-pass processors.</p>
+
 </section>
 
 <section>
@@ -3526,8 +3537,7 @@
   <p>
     JSON-LD is intended to have an easy to parse grammar that closely models existing
     practice in using JSON for describing object representations. This allows the use
-    of existing libraries for parsing JSON in a document-oriented fashion, or can allow
-    for stream-based parsing similar to SAX.
+    of existing libraries for parsing JSON.
   </p>
   <p>
     As with other grammars used for describing <tref>Linked Data</tref>, a key concept is that of