Changed context-at-the-top best practice to suggestion
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Tue, 12 Mar 2013 18:29:14 +0100
changeset 1422 2d2b45d6f411
parent 1421 56dfae1c6e1a
child 1423 a5fbf3dd386e
Changed context-at-the-top best practice to suggestion

This addresses #224.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Tue Mar 12 18:20:17 2013 +0100
+++ b/spec/latest/json-ld-syntax/index.html	Tue Mar 12 18:29:14 2013 +0100
@@ -1373,8 +1373,10 @@
   -->
   </pre>
 
-  <p class="note">It is a best practice to put the <tref>context</tref> definition
-    at the top of the JSON-LD document.</p>
+  <p class="note">When possible, the <tref>context</tref> definition should be put
+    at the top of a JSON-LD document. This makes the document easier to read and
+    might make streaming parsers more efficient. Documents that do not have the
+    <tref>context</tref> at the top, are still conformant JSON-LD.</p>
 
   <p class="note">To avoid forward-compatibility issues,
     <tref title="term">terms</tref> starting with an&nbsp;<code>@</code> character are