whatwg
diff --git a/‎dom.bs‎
Lines changed: 12 additions & 11 deletions b/‎dom.bs‎
Lines changed: 12 additions & 11 deletions
@@ -2090,15 +2090,17 @@ interface ParentNode {
   [Unscopeable] void prepend((Node or DOMString)... nodes);
   [Unscopeable] void append((Node or DOMString)... nodes);
 
-  [Unscopeable] Element? query(DOMString relativeSelectors);
-  [NewObject, Unscopeable] Elements queryAll(DOMString relativeSelectors);
   Element? querySelector(DOMString selectors);
   [NewObject] NodeList querySelectorAll(DOMString selectors);
 };
 Document implements ParentNode;
 DocumentFragment implements ParentNode;
 Element implements ParentNode;
 </pre>
+<!--
+  [Unscopeable] Element? query(DOMString relativeSelectors);
+  [NewObject, Unscopeable] Elements queryAll(DOMString relativeSelectors);
+-->
 
 <dl class=domintro>
  <dt><code><var>collection</var> = <var>node</var> . {{ParentNode/children}}</code>
@@ -2136,7 +2138,7 @@ Element implements ParentNode;
   <a>node tree</a> are violated.
   <!-- "NotFoundError" is impossible -->
 
- <dt><code><var>node</var> . <a method for=ParentNode lt="query()">query</a>(<var>relativeSelectors</var>)</code>
+ <!--<dt><code><var>node</var> . <a method for=ParentNode lt="query()">query</a>(<var>relativeSelectors</var>)</code>
  <dd>
   Returns the first <a for="/">element</a> that is a
   <a>descendant</a> of <var>node</var> that
@@ -2146,7 +2148,7 @@ Element implements ParentNode;
  <dd>
   Returns all <a for="/">element</a>
   <a>descendants</a> of <var>node</var> that
-  match <var>relativeSelectors</var>.
+  match <var>relativeSelectors</var>.-->
 
  <dt><code><var>node</var> . <a method for=ParentNode lt="querySelector()">querySelector</a>(<var>selectors</var>)</code>
  <dd>
@@ -2204,15 +2206,15 @@ method must run these steps:
  <var>node</var> to the <a>context object</a>.
 </ol>
 
-The <dfn method for=ParentNode><code>query(<var>relativeSelectors</var>)</code></dfn>
+<!--The <dfn method for=ParentNode><code>query(<var>relativeSelectors</var>)</code></dfn>
 method, when invoked, must return the first result of running
 <a>match a relative selectors string</a> <var>relativeSelectors</var> against
 a set consisting of <a>context object</a>, and null if the result is an empty list.
 
 The <dfn method for=ParentNode><code>queryAll(<var>relativeSelectors</var>)</code></dfn>
 method, when invoked, must return an {{Elements}} array initialized with the result of
 running <a>match a relative selectors string</a> <var>relativeSelectors</var> against
-a set consisting of <a>context object</a>.
+a set consisting of <a>context object</a>.-->
 
 The <dfn method for=ParentNode><code>querySelector(<var>selectors</var>)</code></dfn>
 method, when invoked, must return the first result of running
@@ -2407,7 +2409,7 @@ Text implements Slotable;
 the result of <a>find a slot</a> given <a>context object</a> and with the <i>open flag</i> set.</p>
 
 
-<h4 id=element-collections>Collections: {{Elements}}</h4>
+<!--<h4 id=element-collections>Collections: {{Elements}}</h4>
 
 <pre class='idl' data-no-idl>
 class <dfn interface>Elements</dfn> extends Array {
@@ -2448,7 +2450,7 @@ The <dfn method for=Elements><code>queryAll(<var>relativeSelectors</var>)</code>
 method, when invoked, must return the result of running
 <code class='lang-javascript'>this.constructor</code> with the result of running
 <a>match a relative selectors string</a> <var>relativeSelectors</var> against the
-<a>context object</a>.
+<a>context object</a>.-->
 
 
 <h4 id=old-style-collections>Old-style collections: {{NodeList}} and {{HTMLCollection}}</h4>
@@ -2536,9 +2538,8 @@ interface HTMLCollection {
 
 <p>An {{HTMLCollection}} object is a <a>collection</a> of <a for="/">elements</a>.
 
-<p class="note no-backref">{{Elements}} is the better solution for representing a
-<a>collection</a> of <a for="/">elements</a>. {{HTMLCollection}} is an historical artifact we
-cannot rid the web of.
+<p class="note no-backref">{{HTMLCollection}} is an historical artifact we cannot rid the web of.
+Please do not use it in new APIs.
 
 <dl class=domintro>
  <dt><var>collection</var> . {{HTMLCollection/length}}