Convert all notes containing normative statements to regular paragraphs
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Mon, 22 Oct 2012 21:29:49 +0200
changeset 918 821b3bd9292a
parent 917 e70b24f5af87
child 919 70f241471587
Convert all notes containing normative statements to regular paragraphs
spec/latest/json-ld-api/index.html
spec/latest/json-ld-framing/index.html
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-api/index.html	Mon Oct 22 20:31:40 2012 +0200
+++ b/spec/latest/json-ld-api/index.html	Mon Oct 22 21:29:49 2012 +0200
@@ -691,7 +691,7 @@
     <p>The JSON-LD processor interface is the high-level programming structure that developers
       use to access the JSON-LD transformation methods.</p>
 
-    <p class="note">The JSON-LD API signatures are the same across all programming languages. Due
+    <p>The JSON-LD API signatures are the same across all programming languages. Due
       to the fact that asynchronous programming is uncommon in certain languages, developers MAY
       implement a processor with a synchronous interface instead. In that case, the <code>callback</code>
       parameter MUST NOT be included and the result MUST be returned as a return value instead.</p>
@@ -1114,7 +1114,7 @@
       most recent processing run on the document. <a>BlankNode</a>
       values will often be generated differently by different processors.</p>
 
-    <p class="note">Implementers MUST ensure that <a>BlankNode</a> values are unique
+    <p>Implementers MUST ensure that <a>BlankNode</a> values are unique
       within the current environment, two <ldtref title="BlankNode">BlankNodes</ldtref>
       are considered equal if, and only if, their values are strictly equal.</p>
     </section>
@@ -2525,7 +2525,7 @@
   automatically converted back to their JSON-native counterparts in when
   <a href="#rdf-conversion">converting from RDF</a>.</p>
 
-<p class="note">Some JSON serializers, such as PHP's native implementation in some versions,
+<p>Some JSON serializers, such as PHP's native implementation in some versions,
   backslash-escape the forward slash character. For example, the value
   <code>http://example.com/</code> would be serialized as <code>http:\/\/example.com\/</code>.
   This is problematic as other JSON parsers might not understand those escaping characters.
--- a/spec/latest/json-ld-framing/index.html	Mon Oct 22 20:31:40 2012 +0200
+++ b/spec/latest/json-ld-framing/index.html	Mon Oct 22 21:29:49 2012 +0200
@@ -434,11 +434,6 @@
       use to access the JSON-LD transformation methods. The definition below is an experimental
       extension of the interface defined in the [[JSON-LD-API]].</p>
 
-    <p class="note">The JSON-LD API signatures are the same across all programming languages. Due
-      to the fact that asynchronous programming is uncommon in certain languages, developers MAY
-      implement processor with a synchronous interface instead. In that case, the <code>callback</code>
-      parameter MUST NOT be included and the result MUST be returned as return value instead.</p>
-
     <dl title="[NoInterfaceObject] interface JsonLdProcessor" class="idl">
 
       <dt>void frame()</dt>
--- a/spec/latest/json-ld-syntax/index.html	Mon Oct 22 20:31:40 2012 +0200
+++ b/spec/latest/json-ld-syntax/index.html	Mon Oct 22 21:29:49 2012 +0200
@@ -519,12 +519,13 @@
       zeros are not allowed.</dd>
     <dt><tdef>true</tdef> and <tdef>false</tdef></dt><dd>
       Values that are used to express one of two possible boolean states.</dd>
-    <dt><tdef>null</tdef></dt><dd>
-      The null value is used to make a JSON-LD processor "forget" any
-      previously defined JSON key that is associated with the null value.
-      If a previous definition doesn't exist, the entire key-value is ignored.
-      If a previous definition of the key does exist, the previous
-      definition is undefined.</dd>
+    <dt><tdef>null</tdef></dt>
+    <dd>The <code>null</code> value is processed in a special way in JSON-LD.
+      Unless otherwise specified, a JSON-LD processor MUST act as if a
+      key-value pair in the body of a JSON-LD document was never declared
+      when the value equals <em>null</em>. If <code>@value</code>,
+      <code>@list</code>, or <code>@set</code> is set to <em>null</em> in
+      expanded form, then the entire <tref>JSON object</tref> is ignored.</dd>
     <dt><tdef>node definition</tdef></dt><dd>
       A <tref>JSON object</tref> used to represent a <tref>node</tref> and
       one or more properties of that node. A <tref>JSON object</tref> is a
@@ -688,7 +689,7 @@
 for certain <tref>term</tref>s as well as other processing instructions for
 the JSON-LD processor.</p>
 
-<p class="note">External JSON-LD context documents MAY contain extra information
+<p>External JSON-LD context documents MAY contain extra information
 located outside of the <code>@context</code> key, such as documentation about the
 <tref title="term">terms</tref> declared in the document. When importing a
 <code>@context</code> value from an external JSON-LD context document, any extra
@@ -756,11 +757,10 @@
   more deeply nested <code>details</code> structure. Note that this is
   rarely a good authoring practice and is typically used when there exist
   legacy applications that depend on the specific structure of the
-  <tref>JSON object</tref>.</p>
-
-<p class="note">If a <tref>term</tref> is re-defined within a context, all previous
-  rules associated with the previous definition are removed. A <tref>term</tref> defined
-  in a previous context MUST be removed, if it is re-defined to <code>null</code>.</p>
+  <tref>JSON object</tref>. If a <tref>term</tref> is re-defined within a
+  context, all previous rules associated with the previous definition are
+  removed. A <tref>term</tref> defined in a previous context MUST be removed,
+  if it is re-defined to <code>null</code>.</p>
 
 <p>The set of contexts defined within a specific <tref>node definition</tref> are
   referred to as <tdef>local context</tdef>s. Setting the context to <code>null</code>
@@ -793,16 +793,6 @@
   This creates a memory and complexity burden for certain types of
   low-memory footprint JSON-LD processors.</p>
 
-<p class="note">The <code>null</code> value is processed in a special way
-  in JSON-LD. Unless otherwise specified, a JSON-LD processor MUST act as if a
-  key-value pair in the body of a JSON-LD document was never declared when
-  the value equals <em>null</em>. If <code>@value</code>, <code>@list</code>,
-  or <code>@set</code> is set to <em>null</em> in expanded form, then the
-  entire <tref>JSON object</tref> is ignored. If <code>@context</code> is set
-  to <em>null</em>, the <tref>active context</tref> is reset and when used
-  within a <tref>context</tref>, it removes any definition associated with
-  the key, unless otherwise specified.</p>
-
 </section>
 
 <section>
@@ -975,7 +965,7 @@
 -->
 </pre>
 
-<p class="note">Specifying a <tref>JSON object</tref> with an
+<p>Specifying a <tref>JSON object</tref> with an
   <code>@id</code> key is used to identify that <tref>node</tref> using an
   <tref>IRI</tref>. When the object has only the <code>@id</code>, it
   is called a <tref>node reference</tref>.
@@ -1064,18 +1054,6 @@
   <tref>unlabeled node</tref>. <tref title="node definition">Node definitions</tref> MAY
   be spread among different parts of a document or even between different documents.</p>
 
-<p class="note">To ensure the best possible performance, when possible, it is a best practice
-  to put JSON-LD <tref>keyword</tref>s, such as <code>@id</code> and
-  <code>@context</code> before other key-value pairs in a <tref>JSON object</tref>.
-  However, keys in a <tref>JSON object</tref> are not ordered,
-  so processors MUST NOT depend on key ordering. If keywords are not listed
-  first, processors have to save each key-value pair until at least the
-  <code>@context</code> and the <code>@id</code> are processed. Not
-  specifying those keywords first creates a memory and complexity burden for
-  low-memory footprint processors, forcing them to use more memory and
-  computing cycles than necessary.</p>
-
-
 </section>
 
 <section>
@@ -1187,8 +1165,8 @@
 -->
 </pre>
 
-<p class="note">Please note that language associations MUST only be applied
-  to plain literal <tref>string</tref>s. That is, <tref>typed value</tref>s
+<p>Please note that language associations MUST only be applied to plain
+  literal <tref>string</tref>s. That is, <tref>typed value</tref>s
   or values that are subject to <a href="#type-coercion"></a>
   won't be language tagged.</p>
 
@@ -1215,8 +1193,7 @@
 </pre>
 
 <p class="note">JSON-LD allows one to associate language information with
-  <tref>term</tref>s.
-  See <a href="#expanded-term-definition"></a> for
+  <tref>term</tref>s. See <a href="#expanded-term-definition"></a> for
   more details.</p>
 
 </section>
@@ -1624,9 +1601,10 @@
 -->
 </pre>
 
-<p class="note">JSON-LD documents served with the <code>application/ld+json</code> media type
-  MUST have all context information, including references to external contexts, within the
-  body of the document.</p>
+<p>Please note that JSON-LD documents served with the <code>application/ld+json</code>
+  media type MUST have all context information, including references to external
+  contexts, within the body of the document. Contexts linked via a
+  <code>describedby</code> HTTP Link Header MUST be ignored for such documents.</p>
 </section>
 
 <section>