Merge pull request #220 from zolkis/namespace-wot

Fix #215: make the API entry point a namespace.

Author: zolkis

index.html

@@ -370,24 +370,20 @@ <h2>The <dfn>ThingDescription</dfn> type</h2>
   </section>
 
   <section data-dfn-for="WOT">
-  <h2>The <dfn>WoT API object</dfn></h2>
+  <h2>The <dfn>WOT</dfn> namespace</dfn></h2>
   <p>
-    Defines the API entry point exposed as a singleton and contains the API methods.
+    Defines the <dfn>WoT API object</dfn> as a singleton and contains the API
+    methods, grouped by conformance classes.
   </p>
-  <section> <h3>The <dfn>WOT</dfn> interface</h3>
-    <pre class="idl">
-      [SecureContext, Exposed=(Window,Worker)]
-      interface WOT {
-        // methods defined in UA conformance classes
-      };
-    </pre>
-    <p class="note">
-       Browser implementations should use a namespace object such as <code>navigator.wot</code>. Standalone runtimes may expose the API object through mechanisms like <a href="https://nodejs.org/api/modules.html">require()</a> or <a href="http://www.ecma-international.org/ecma-262/6.0/#sec-imports">import</a>.
-    </p>
-  </section>
+  <pre class="idl">
+    [SecureContext, Exposed=(Window,Worker)]
+    namespace WOT {
+      // methods defined in UA conformance classes
+    };
+  </pre>
   <section> <h3>The <dfn>consume()</dfn> method</h3>
     <pre class="idl">
-      partial interface WOT {
+      partial namespace WOT {
         Promise&lt;ConsumedThing&gt; consume(ThingDescription td);
       };
     </pre>
@@ -423,7 +419,7 @@ <h2>The <dfn>WoT API object</dfn></h2>
 
   <section> <h3>The <dfn>produce()</dfn> method</h3>
     <pre class="idl">
-      partial interface WOT {
+      partial namespace WOT {
         Promise&lt;ExposedThing&gt; produce(ThingDescription td);
       };
     </pre>
@@ -448,7 +444,7 @@ <h2>The <dfn>WoT API object</dfn></h2>
 
   <section> <h3>The <dfn>discover()</dfn> method</h3>
     <pre class="idl">
-      partial interface WOT {
+      partial namespace WOT {
         ThingDiscovery discover(optional ThingFilter filter = null);
       };
     </pre>