Merge pull request #259 from zolkis/consume-ctor

Fix #244: ConsumeThing constructor and consume() should do the same

Author: zolkis

index.html

@@ -414,9 +414,6 @@ <h2>The <dfn>WOT</dfn> namespace</dfn></h2>
         <li>
           If invoking this method is not allowed for the current scripting context for security reasons, reject |promise| with a {{SecurityError}} and abort these steps.
         </li>
-        <li>
-          Run the <a>validate a TD</a> steps on |td|. If that fails, reject |promise| with {{SyntaxError}} and abort these steps.
-        </li>
         <li>
           Let |thing:ConsumedThing| be a new {{ConsumedThing}} object constructed from |td|.
         </li>
@@ -432,6 +429,12 @@ <h2>The <dfn>WOT</dfn> namespace</dfn></h2>
           Resolve |promise| with |thing|.
         </li>
       </ol>
+      <p class="ednote">
+        Note the difference between constructing <a>ConsumedThing</a> and using
+        the <code>consume()</code> method: the latter also initializes the protocol
+        bindings, whereas a simple constructed object will not have <a>WoT Interactions</a>
+        initialized until they are invoked.
+      </p>
     </div>
   </section>
 
@@ -1053,6 +1056,10 @@ <h4>Constructing <code>ConsumedThing</code></h4>
         To create {{ConsumedThing}} with the {{ThingDescription}}
         |td:ThingDescription|, run the following steps:
         <ol>
+          <li>
+            Run the <a>validate a TD</a> steps on |td|. If that fails,
+            [= exception/throw =] {{SyntaxError}} and abort these steps.
+          </li>
           <li>
             Run the <a>expand a TD</a> steps on |td|. If that fails, re-[= exception/throw =] the error and abort these steps.
           </li>