From 1558caa18b4da662a3f669028946c46a33f07d40 Mon Sep 17 00:00:00 2001
From: Will Bamberg <will@bootbonnet.ca>
Date: Mon, 30 Aug 2021 22:03:38 -0700
Subject: [PATCH 1/2] Fix various unconvertible dl elements in Web/API
---
.../api/analysernode/analysernode/index.html | 19 +++---
.../registerprocessor/index.html | 10 +--
files/en-us/web/api/caretposition/index.html | 2 +-
.../en-us/web/api/cssgroupingrule/index.html | 2 +-
.../datatransfer/mozcleardataat/index.html | 7 +--
.../api/datatransfer/mozsetdataat/index.html | 7 +--
.../web/api/datatransfer/setdata/index.html | 7 +--
files/en-us/web/api/fileentrysync/index.html | 11 ++--
.../getfilehandle/index.html | 1 +
.../web/api/filesystementrysync/index.html | 61 +++++++------------
files/en-us/web/api/html_dom_api/index.html | 21 +++----
.../en-us/web/api/localfilesystem/index.html | 22 +++----
.../mediaquerylistevent/index.html | 7 +--
.../mediarecorder/mediarecorder/index.html | 4 +-
.../api/messageevent/messageevent/index.html | 4 +-
.../web/api/microdata_dom_api/index.html | 2 +-
.../en-us/web/api/ndefreader/scan/index.html | 1 +
.../en-us/web/api/ndefreader/write/index.html | 2 +-
files/en-us/web/api/notification/index.html | 2 +-
files/en-us/web/api/request/mode/index.html | 4 +-
.../en-us/web/api/rtcconfiguration/index.html | 22 +++----
.../web/api/serial/requestport/index.html | 1 +
.../preserveaspectratio/index.html | 18 +++---
23 files changed, 97 insertions(+), 140 deletions(-)
diff --git a/files/en-us/web/api/analysernode/analysernode/index.html b/files/en-us/web/api/analysernode/analysernode/index.html
index 78770c8f3df8576..055c8bfac4585b3 100644
--- a/files/en-us/web/api/analysernode/analysernode/index.html
+++ b/files/en-us/web/api/analysernode/analysernode/index.html
@@ -28,15 +28,16 @@ <h3 id="Parameters">Parameters</h3>
<dd>A reference to an {{domxref("AudioContext")}} or {{domxref("OfflineAudioContext")}}.</dd>
<dt><em>options</em> {{optional_inline}}</dt>
<dd>
- <ul>
- <li><strong><code>fftSize</code></strong>: The desired initial size of the <a href="https://en.wikipedia.org/wiki/Fast_Fourier_transform">FFT</a> for <a href="https://en.wikipedia.org/wiki/Frequency_domain">frequency-domain</a> analysis. <br>
- The default is <code>2048</code>.</li>
- <li><strong><code>maxDecibels</code></strong>: The desired initial maximum power in <a href="https://en.wikipedia.org/wiki/Decibel">dB</a> for FFT analysis.<br>
- The default is <code>-30</code>.</li>
- <li><strong><code>minDecibels</code></strong>: The desired initial minimum power in dB for FFT analysis.<br>
- The default is <code>-100</code>.</li>
- <li><strong><code>smoothingTimeConstant</code></strong>: The desired initial smoothing constant for the FFT analysis. The default is <code>0.8</code>.</li>
- </ul>
+ <p>An object with the following properties, all optional:</p>
+ <ul>
+ <li><strong><code>fftSize</code></strong>: The desired initial size of the <a href="https://en.wikipedia.org/wiki/Fast_Fourier_transform">FFT</a> for <a href="https://en.wikipedia.org/wiki/Frequency_domain">frequency-domain</a> analysis. <br>
+ The default is <code>2048</code>.</li>
+ <li><strong><code>maxDecibels</code></strong>: The desired initial maximum power in <a href="https://en.wikipedia.org/wiki/Decibel">dB</a> for FFT analysis.<br>
+ The default is <code>-30</code>.</li>
+ <li><strong><code>minDecibels</code></strong>: The desired initial minimum power in dB for FFT analysis.<br>
+ The default is <code>-100</code>.</li>
+ <li><strong><code>smoothingTimeConstant</code></strong>: The desired initial smoothing constant for the FFT analysis. The default is <code>0.8</code>.</li>
+ </ul>
</dd>
</dl>
diff --git a/files/en-us/web/api/audioworkletglobalscope/registerprocessor/index.html b/files/en-us/web/api/audioworkletglobalscope/registerprocessor/index.html
index 96b3e6ca6d15d4f..3aa63901d3b5cac 100644
--- a/files/en-us/web/api/audioworkletglobalscope/registerprocessor/index.html
+++ b/files/en-us/web/api/audioworkletglobalscope/registerprocessor/index.html
@@ -48,17 +48,19 @@ <h3 id="Exceptions">Exceptions</h3>
<dl>
<dt><code>NotSupportedError</code></dt>
<dd>
+ <p>Thrown under the following conditions:</p>
<ul>
- <li>The <em>name</em> is an empty string, or</li>
- <li>a constructor under the given <em>name</em> is already registered. Registering
+ <li>The <em>name</em> is an empty string.</li>
+ <li>A constructor under the given <em>name</em> is already registered. Registering
the same name twice is not allowed.</li>
</ul>
</dd>
<dt><code>TypeError</code></dt>
<dd>
+ <p>Thrown under the following conditions:</p>
<ul>
- <li>The <em>processorCtor</em> is not a callable constructor, or</li>
- <li>the {{domxref("AudioWorkletProcessor.parameterDescriptors",
+ <li>The <em>processorCtor</em> is not a callable constructor.</li>
+ <li>The {{domxref("AudioWorkletProcessor.parameterDescriptors",
"parameterDescriptors")}} property of the constructor exists and doesn't return an
array of {{domxref("AudioParamDescriptor")}}-based objects.</li>
</ul>
diff --git a/files/en-us/web/api/caretposition/index.html b/files/en-us/web/api/caretposition/index.html
index eb9b3d5c95bb0b6..449ab890dd9e211 100644
--- a/files/en-us/web/api/caretposition/index.html
+++ b/files/en-us/web/api/caretposition/index.html
@@ -28,7 +28,7 @@ <h2 id="Methods">Methods</h2>
<dl>
<dt>{{domxref("CaretPosition.getClientRect")}}</dt>
- <dd></dd>
+ <dd>Returns the client rectangle for the caret range.</dd>
</dl>
<h2 id="Specifications">Specifications</h2>
diff --git a/files/en-us/web/api/cssgroupingrule/index.html b/files/en-us/web/api/cssgroupingrule/index.html
index 07fa08b76cfade3..c22bbbd0d4e8df7 100644
--- a/files/en-us/web/api/cssgroupingrule/index.html
+++ b/files/en-us/web/api/cssgroupingrule/index.html
@@ -17,7 +17,7 @@ <h2 id="Properties">Properties</h2>
<p><em>This interface also inherits properties from {{domxref("CSSRule")}}.</em></p>
<dl>
- <dt">{{domxref("CSSGroupingRule.cssRules")}}{{readonlyinline}}</dt>
+ <dt>{{domxref("CSSGroupingRule.cssRules")}}{{readonlyinline}}</dt>
<dd>Returns a {{domxref("CSSRuleList")}} of the CSS rules in the media rule.</dd>
</dl>
diff --git a/files/en-us/web/api/datatransfer/mozcleardataat/index.html b/files/en-us/web/api/datatransfer/mozcleardataat/index.html
index 27213fba98b21e4..449769694333115 100644
--- a/files/en-us/web/api/datatransfer/mozcleardataat/index.html
+++ b/files/en-us/web/api/datatransfer/mozcleardataat/index.html
@@ -45,10 +45,7 @@ <h3 id="Arguments">Arguments</h3>
<h3 id="Return_Value">Return value</h3>
-<dl>
- <dt>void</dt>
- <dd></dd>
-</dl>
+<p>None.</p>
<h2 id="Example">Example</h2>
@@ -79,4 +76,4 @@ <h2 id="See_also">See also</h2>
<li><a href="/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Recommended_drag_types">Recommended Drag Types</a></li>
<li><a href="/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Multiple_items">Dragging and Dropping Multiple Items</a></li>
<li><a href="https://codepen.io/tech_query/pen/MqGgap">DataTransfer test - Paste or Drag</a></li>
-</ul>
\ No newline at end of file
+</ul>
diff --git a/files/en-us/web/api/datatransfer/mozsetdataat/index.html b/files/en-us/web/api/datatransfer/mozsetdataat/index.html
index 15bb1291e4c0c0e..436cc247364796a 100644
--- a/files/en-us/web/api/datatransfer/mozsetdataat/index.html
+++ b/files/en-us/web/api/datatransfer/mozsetdataat/index.html
@@ -55,10 +55,7 @@ <h3 id="Arguments">Arguments</h3>
<h3 id="Return_Value">Return value</h3>
-<dl>
- <dt>void</dt>
- <dd></dd>
-</dl>
+<p>None.</p>
<h2 id="Example">Example</h2>
@@ -93,4 +90,4 @@ <h2 id="See_also">See also</h2>
<li><a href="/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Recommended_drag_types">Recommended Drag Types</a></li>
<li><a href="/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Multiple_items">Dragging and Dropping Multiple Items</a></li>
<li><a href="https://codepen.io/tech_query/pen/MqGgap">DataTransfer test - Paste or Drag</a></li>
-</ul>
\ No newline at end of file
+</ul>
diff --git a/files/en-us/web/api/datatransfer/setdata/index.html b/files/en-us/web/api/datatransfer/setdata/index.html
index 578758e91c62082..f9cad86500f83e9 100644
--- a/files/en-us/web/api/datatransfer/setdata/index.html
+++ b/files/en-us/web/api/datatransfer/setdata/index.html
@@ -40,10 +40,7 @@ <h3 id="Arguments">Arguments</h3>
<h3 id="Return_value">Return value</h3>
-<dl>
- <dt>void</dt>
- <dd></dd>
-</dl>
+<p>None.</p>
<h2 id="Example">Example</h2>
@@ -120,4 +117,4 @@ <h2 id="See_also">See also</h2>
<li><a href="/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Recommended_drag_types">Recommended Drag Types</a></li>
<li><a href="/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Multiple_items">Dragging and Dropping Multiple Items</a></li>
<li><a href="https://codepen.io/tech_query/pen/MqGgap">DataTransfer test - Paste or Drag</a></li>
-</ul>
\ No newline at end of file
+</ul>
diff --git a/files/en-us/web/api/fileentrysync/index.html b/files/en-us/web/api/fileentrysync/index.html
index 29c6068cab36803..e43765635ca0e6c 100644
--- a/files/en-us/web/api/fileentrysync/index.html
+++ b/files/en-us/web/api/fileentrysync/index.html
@@ -48,18 +48,15 @@ <h3 id="createWriter">createWriter()</h3>
<pre>void createWriter (
) raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</pre>
-<h5 id="Parameter">Parameter</h5>
+<h4 id="Parameter">Parameter</h4>
<p>None.</p>
-<h5 id="Returns">Returns</h5>
+<h4 id="Returns">Returns</h4>
-<dl>
- <dt><code>FileWriterSync</code></dt>
- <dd></dd>
-</dl>
+<p>A <code>FileWriterSync</code> object.</p>
-<h5 id="Exceptions">Exceptions</h5>
+<h4 id="Exceptions">Exceptions</h4>
<p>This method can raise a <a href="/en-US/docs/Web/API/FileException">FileException</a> with the following codes:</p>
diff --git a/files/en-us/web/api/filesystemdirectoryhandle/getfilehandle/index.html b/files/en-us/web/api/filesystemdirectoryhandle/getfilehandle/index.html
index e58841ed6b101b7..bc29d52d81d11cd 100644
--- a/files/en-us/web/api/filesystemdirectoryhandle/getfilehandle/index.html
+++ b/files/en-us/web/api/filesystemdirectoryhandle/getfilehandle/index.html
@@ -30,6 +30,7 @@ <h3 id="Parameters">Parameters</h3>
the file you wish to retrieve.</dd>
<dt><em>options</em> {{optional_inline}}</dt>
<dd>
+ <p>An object with the following properties:</p>
<ul>
<li><code>create</code>: A {{jsxref('Boolean')}}. Default <code>false</code>. When
set to <code>true</code> if the file is not found, one with the specified name
diff --git a/files/en-us/web/api/filesystementrysync/index.html b/files/en-us/web/api/filesystementrysync/index.html
index 9524c04bb710ebe..42e4051eb1d87b2 100644
--- a/files/en-us/web/api/filesystementrysync/index.html
+++ b/files/en-us/web/api/filesystementrysync/index.html
@@ -108,18 +108,15 @@ <h3 id="getMetadata">getMetadata()</h3>
<pre>Metadata getMetada ()
raises <code>(<a href="/en-US/docs/Web/API/FileException">FileException</a>)</code>;</pre>
-<h5 id="Parameter">Parameter</h5>
+<h4 id="Parameter">Parameter</h4>
<p>None</p>
-<h5 id="Returns">Returns</h5>
+<h4 id="Returns">Returns</h4>
-<dl>
- <dt><code>Metadata</code></dt>
- <dd></dd>
-</dl>
+<p>A <code>Metadata</code> object.</p>
-<h5 id="Exceptions">Exceptions</h5>
+<h4 id="Exceptions">Exceptions</h4>
<p>This method can raise a <a href="/en-US/docs/Web/API/FileException">FileException</a> with the following codes:</p>
@@ -161,7 +158,7 @@ <h3 id="moveTo">moveTo()</h3>
in DirectoryEntrySync <em>parent</em>, optional DOMString <em>newName</em>
) raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</pre>
-<h5 id="Parameters">Parameters</h5>
+<h4 id="Parameters">Parameters</h4>
<dl>
<dt>parent</dt>
@@ -170,14 +167,11 @@ <h5 id="Parameters">Parameters</h5>
<dd>The new name of the entry. If you do not specify a name, the browser preserves the entry's current name.</dd>
</dl>
-<h5 id="Returns_2">Returns</h5>
+<h4 id="Returns_2">Returns</h4>
-<dl>
- <dt><code>FileSystemEntrySync</code></dt>
- <dd>An object that represents an entry in the file system.</dd>
-</dl>
+<p>A <code>FileSystemEntrySync</code> object.</p>
-<h5 id="Exceptions_2">Exceptions</h5>
+<h4 id="Exceptions_2">Exceptions</h4>
<p>This method can raise a <a href="/en-US/docs/Web/API/FileException">FileException</a> with the following codes:</p>
@@ -223,7 +217,7 @@ <h3 id="copyTo">copyTo()</h3>
in DirectoryEntrySync <em>parent</em>, optional DOMString <em>newName</em>
) raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</pre>
-<h5 id="Parameters_2">Parameters</h5>
+<h4 id="Parameters_2">Parameters</h4>
<dl>
<dt>parent</dt>
@@ -232,14 +226,11 @@ <h5 id="Parameters_2">Parameters</h5>
<dd>The new name of the entry. If you do not specify a name, the browser preserves the FileSystemEntrySync's current name.</dd>
</dl>
-<h5 id="Returns_3">Returns</h5>
+<h4 id="Returns_3">Returns</h4>
-<dl>
- <dt><code>FileSystemEntrySync</code></dt>
- <dd>An object that represents an entry in the file system.</dd>
-</dl>
+<p>A <code>FileSystemEntrySync</code> object.</p>
-<h5 id="Exceptions_3">Exceptions</h5>
+<h4 id="Exceptions_3">Exceptions</h4>
<p>This method can raise a <a href="/en-US/docs/Web/API/FileException">FileException</a> with the following codes:</p>
@@ -291,18 +282,15 @@ <h3 id="toURL">toURL()</h3>
<pre>DOMString toURL ();</pre>
-<h5 id="Parameter_2">Parameter</h5>
+<h4 id="Parameter_2">Parameter</h4>
<p>None.</p>
-<h5 id="Returns_4">Returns</h5>
+<h4 id="Returns_4">Returns</h4>
-<dl>
- <dt><code>DOMString</code></dt>
- <dd></dd>
-</dl>
+<p>A <code>DOMString</code> object.</p>
-<h5 id="Exceptions_4">Exceptions</h5>
+<h4 id="Exceptions_4">Exceptions</h4>
<p>None</p>
@@ -313,18 +301,15 @@ <h3 id="remove">remove()</h3>
<pre>void remove (
) raises (<a href="/en-US/docs/Web/API/FileException">FileException</a>);</pre>
-<h5 id="Parameter_3">Parameter</h5>
+<h4 id="Parameter_3">Parameter</h4>
<p>None</p>
-<h5 id="Returns_5">Returns</h5>
+<h4 id="Returns_5">Returns</h4>
-<dl>
- <dt><code>void</code></dt>
- <dd></dd>
-</dl>
+<p>None.</p>
-<h5 id="Exceptions_5">Exceptions</h5>
+<h4 id="Exceptions_5">Exceptions</h4>
<p>This method can raise a <a href="/en-US/docs/Web/API/FileException">FileException</a> with the following codes:</p>
@@ -359,18 +344,18 @@ <h3 id="getParent">getParent()</h3>
<pre>void getParent ();</pre>
-<h5 id="Parameter_4">Parameter</h5>
+<h4 id="Parameter_4">Parameter</h4>
<p>None</p>
-<h5 id="Returns_6">Returns</h5>
+<h4 id="Returns_6">Returns</h4>
<dl>
<dt><code><a href="/en-US/docs/Web/API/DirectoryEntrySync">DirectoryEntrySync</a></code></dt>
<dd>An object that represents a directory in the file system.</dd>
</dl>
-<h5 id="Exceptions_6">Exceptions</h5>
+<h4 id="Exceptions_6">Exceptions</h4>
<p>None.</p>
diff --git a/files/en-us/web/api/html_dom_api/index.html b/files/en-us/web/api/html_dom_api/index.html
index c51314f0cb0897e..4b6fa743c9d71c2 100644
--- a/files/en-us/web/api/html_dom_api/index.html
+++ b/files/en-us/web/api/html_dom_api/index.html
@@ -439,21 +439,18 @@ <h2 id="Browser_compatibility">Browser compatibility</h2>
<h2 id="See_also">See also</h2>
-<dl>
- <dt>References</dt>
- <dd>
- <ul>
+<h3>References</h3>
+
+<ul>
<li><a href="/en-US/docs/Web/HTML/Element">HTML elements reference</a></li>
<li><a href="/en-US/docs/Web/HTML/Attributes">HTML attribute reference</a></li>
<li>{{DOMxRef("Document_Object_Model", "Document Object Model (DOM)", "", "1")}} reference</li>
- </ul>
- </dd>
- <dt>Guides</dt>
- <dd>
- <ul>
+</ul>
+
+<h3>Guides</h3>
+
+<ul>
<li>
<p><a href="/en-US/docs/Learn/JavaScript/Client-side_web_APIs/Manipulating_documents">Manipulating documents</a>: A beginner's guide to manipulating the DOM.</p>
</li>
- </ul>
- </dd>
-</dl>
+</ul>
diff --git a/files/en-us/web/api/localfilesystem/index.html b/files/en-us/web/api/localfilesystem/index.html
index e8757314d126cf0..68ee1d9237c3603 100644
--- a/files/en-us/web/api/localfilesystem/index.html
+++ b/files/en-us/web/api/localfilesystem/index.html
@@ -116,7 +116,7 @@ <h3 id="requestFileSystem">requestFileSystem()</h3>
in ErrorCallback errorCallback
);</pre>
-<h5 id="Parameters">Parameters</h5>
+<h4 id="Parameters">Parameters</h4>
<dl>
<dt>type</dt>
@@ -134,14 +134,11 @@ <h5 id="Parameters">Parameters</h5>
<dd>The error callback that is called when errors happen or when the request to obtain the file system is denied. Its argument is the <code>FileError</code> object.</dd>
</dl>
-<h5 id="Returns">Returns</h5>
+<h4 id="Returns">Returns</h4>
-<dl>
- <dt><code>void</code></dt>
- <dd></dd>
-</dl>
+<p>None.</p>
-<h5 id="Exceptions">Exceptions</h5>
+<h4 id="Exceptions">Exceptions</h4>
<p>This method can raise an <a href="/en-US/docs/Web/API/FileError">FileError</a> with the following code:</p>
@@ -169,7 +166,7 @@ <h3 id="resolveLocalFileSystemURL()">resolveLocalFileSystemURL()</h3>
);
</pre>
-<h5 id="Parameters_2">Parameters</h5>
+<h4 id="Parameters_2">Parameters</h4>
<dl>
<dt>url</dt>
@@ -180,14 +177,11 @@ <h5 id="Parameters_2">Parameters</h5>
<dd>The error callback that is called when errors happen or when the request to obtain the entry object is denied.</dd>
</dl>
-<h5 id="Returns_2">Returns</h5>
+<h4 id="Returns_2">Returns</h4>
-<dl>
- <dt><code>void</code></dt>
- <dd></dd>
-</dl>
+<p>None.</p>
-<h5 id="Exceptions_2">Exceptions</h5>
+<h4 id="Exceptions_2">Exceptions</h4>
<p>This method can raise an <a href="/en-US/docs/Web/API/FileError">FileError</a> with the following code:</p>
diff --git a/files/en-us/web/api/mediaquerylistevent/mediaquerylistevent/index.html b/files/en-us/web/api/mediaquerylistevent/mediaquerylistevent/index.html
index 277bb36c32259b0..f13d41201bf4c56 100644
--- a/files/en-us/web/api/mediaquerylistevent/mediaquerylistevent/index.html
+++ b/files/en-us/web/api/mediaquerylistevent/mediaquerylistevent/index.html
@@ -17,15 +17,12 @@
<h2 id="Syntax">Syntax</h2>
-<pre
- class="brush: js">var <em>myMqlEvent</em> = <em>new MediaQueryListEvent(init);</em></pre>
+<pre class="brush: js">var <em>myMqlEvent</em> = <em>new MediaQueryListEvent(init);</em></pre>
<h3 id="Parameters">Parameters</h3>
<dl>
- <dt>
- <p>init</p>
- </dt>
+ <dt><code>init</code></dt>
<dd>
<p>An init object that defines features of the new object instance. The available
properties are:</p>
diff --git a/files/en-us/web/api/mediarecorder/mediarecorder/index.html b/files/en-us/web/api/mediarecorder/mediarecorder/index.html
index 71bea22792839f9..f9193074c01e5d1 100644
--- a/files/en-us/web/api/mediarecorder/mediarecorder/index.html
+++ b/files/en-us/web/api/mediarecorder/mediarecorder/index.html
@@ -38,9 +38,7 @@ <h3 id="Parameters">Parameters</h3>
from a stream created using {{domxref("MediaDevices.getUserMedia",
"navigator.mediaDevices.getUserMedia()")}} or from an {{HTMLElement("audio")}},
{{HTMLElement("video")}} or {{HTMLElement("canvas")}} element.</dd>
- <dt>
- <p><strong><code>options</code> </strong>{{optional_inline}}</p>
- </dt>
+ <dt><strong><code>options</code> </strong>{{optional_inline}}</dt>
<dd>
<p>A dictionary object that can contain the following properties:</p>
diff --git a/files/en-us/web/api/messageevent/messageevent/index.html b/files/en-us/web/api/messageevent/messageevent/index.html
index bbfb356793f3b69..d67e6d57034d7aa 100644
--- a/files/en-us/web/api/messageevent/messageevent/index.html
+++ b/files/en-us/web/api/messageevent/messageevent/index.html
@@ -26,9 +26,7 @@ <h3 id="Parameters">Parameters</h3>
<dt><code><strong>type</strong></code></dt>
<dd>The type of <code>MessageEvent</code> that will be created. This can be one of XXX
</dd>
- <dt>
- <p><strong><code>init</code> </strong>{{optional_inline}}</p>
- </dt>
+ <dt><strong><code>init</code> </strong>{{optional_inline}}</dt>
<dd>
<p>A dictionary object that can contain the following properties:</p>
diff --git a/files/en-us/web/api/microdata_dom_api/index.html b/files/en-us/web/api/microdata_dom_api/index.html
index c189430a97db601..000f5a932c9527c 100644
--- a/files/en-us/web/api/microdata_dom_api/index.html
+++ b/files/en-us/web/api/microdata_dom_api/index.html
@@ -136,7 +136,7 @@ <h3 id="Interface_description_language">Interface description language</h3>
<dt><code>collection . length</code></dt>
<dd>Returns the number of elements in the collection.</dd>
<dt><code>element = collection . item(index)</code></dt>
- <dd></dd>
+ <dd>Returns the element with index from the collection. The items are sorted in tree order.</dd>
<dt><code>collection[index]</code></dt>
<dd>Returns the element with index from the collection. The items are sorted in tree order.</dd>
<dt><code>propertyNodeList = collection . namedItem(name)</code></dt>
diff --git a/files/en-us/web/api/ndefreader/scan/index.html b/files/en-us/web/api/ndefreader/scan/index.html
index 7a4cf5fe4d0d7ed..63d8ecda32efe18 100644
--- a/files/en-us/web/api/ndefreader/scan/index.html
+++ b/files/en-us/web/api/ndefreader/scan/index.html
@@ -22,6 +22,7 @@ <h3 id="Parameters">Parameters</h3>
<dl>
<dt><code>options</code> {{optional_inline}}</dt>
<dd>
+ <p>An object with the following properties:</p>
<ul>
<li><code>signal</code> -- An {{DOMxRef("AbortSignal")}} that allows cancelling
this <code>scan()</code> operation.</li>
diff --git a/files/en-us/web/api/ndefreader/write/index.html b/files/en-us/web/api/ndefreader/write/index.html
index d4feb389ccd5ed5..7d8d31d5b0353a6 100644
--- a/files/en-us/web/api/ndefreader/write/index.html
+++ b/files/en-us/web/api/ndefreader/write/index.html
@@ -39,7 +39,7 @@ <h3 id="Parameters">Parameters</h3>
<dd>A string indicating the type of data stored in <code>data</code>. It must be one of the following values:
<dl>
<dt><code>"absolute-url"</code></dt>
- <dt>An absolute URL to the data.</dt>
+ <dd>An absolute URL to the data.</dd>
<dt><code>"empty"</code></dt>
<dd>An empty {{domxref("NDEFRecord")}}.</dd>
<dt><code>"mime"</code></dt>
diff --git a/files/en-us/web/api/notification/index.html b/files/en-us/web/api/notification/index.html
index d285307821a77c5..9fde64d9110e782 100644
--- a/files/en-us/web/api/notification/index.html
+++ b/files/en-us/web/api/notification/index.html
@@ -38,7 +38,7 @@ <h3 id="Static_properties">Static properties</h3>
</ul>
</dd>
<dt>{{domxref("Notification.maxActions")}} {{readonlyinline}}</dt>
- <dd></dd>
+ <dd>The maximum number of actions supported by the device and the User Agent.</dd>
</dl>
<h3 id="Instance_properties">Instance properties</h3>
diff --git a/files/en-us/web/api/request/mode/index.html b/files/en-us/web/api/request/mode/index.html
index eafa56934cf77c6..3d2bacfc5d44f5a 100644
--- a/files/en-us/web/api/request/mode/index.html
+++ b/files/en-us/web/api/request/mode/index.html
@@ -26,9 +26,7 @@ <h2 id="Syntax">Syntax</h2>
<h3 id="Value">Value</h3>
<dl>
- <dt>
- <p>A <code>RequestMode</code> value.</p>
- </dt>
+ <dt>A <code>RequestMode</code> value.</dt>
<dd>
<p>The associated <dfn>mode</dfn>, available values of which are:</p>
diff --git a/files/en-us/web/api/rtcconfiguration/index.html b/files/en-us/web/api/rtcconfiguration/index.html
index 01985e2f0ac5ff7..c6365f1cdeec958 100644
--- a/files/en-us/web/api/rtcconfiguration/index.html
+++ b/files/en-us/web/api/rtcconfiguration/index.html
@@ -113,23 +113,17 @@ <h2 id="Properties">Properties</h2>
<dt>{{domxref("RTCConfiguration.iceTransportPolicy", "iceTransportPolicy")}} {{optional_inline}}</dt>
<dd>
- The current ICE transport policy;
+ <p>The current ICE transport policy;
if the policy isn't specified, <code>all</code> is assumed by default,
allowing all candidates to be considered.
- Possible values are:
+ Possible values are:</p>
<dl>
- <tr>
- <td><code>"all"</code></td>
- <td>All ICE candidates will be considered.</td>
- </tr>
- <tr>
- <td><code>"public" </code>{{deprecated_inline}}</td>
- <td>Only ICE candidates with public IP addresses will be considered. <em>Removed from the specification's May 13, 2016 working draft.</em></td>
- </tr>
- <tr>
- <td><code>"relay"</code></td>
- <td>Only ICE candidates whose IP addresses are being relayed, such as those being passed through a STUN or TURN server, will be considered.</td>
- </tr>
+ <dt><code>"all"</code></dt>
+ <dd>All ICE candidates will be considered.</dd>
+ <dt><code>"public" </code>{{deprecated_inline}}</dt>
+ <dd>Only ICE candidates with public IP addresses will be considered. <em>Removed from the specification's May 13, 2016 working draft.</em></dd>
+ <dt><code>"relay"</code></dt>
+ <dd>Only ICE candidates whose IP addresses are being relayed, such as those being passed through a STUN or TURN server, will be considered.</dd>
</dl>
</dd>
diff --git a/files/en-us/web/api/serial/requestport/index.html b/files/en-us/web/api/serial/requestport/index.html
index 53d406491bb0a46..7a74ce9c4e60e46 100644
--- a/files/en-us/web/api/serial/requestport/index.html
+++ b/files/en-us/web/api/serial/requestport/index.html
@@ -22,6 +22,7 @@ <h3 id="Parameters">Parameters</h3>
<dl>
<dt>options</dt>
<dd>
+ <p>An object with the following properties:</p>
<dl>
<dt><code>filters</code></dt>
<dd>A list of objects containing vendor and product IDs used to search for attached devices. The <a href="https://www.usb.org/">USB Implementors Forum</a> assigns IDs to specific companies. Each company assigns IDS to it's products. Filters contain the following values:
diff --git a/files/en-us/web/api/svgmarkerelement/preserveaspectratio/index.html b/files/en-us/web/api/svgmarkerelement/preserveaspectratio/index.html
index d50711326f1d94f..d609a36c36effa8 100644
--- a/files/en-us/web/api/svgmarkerelement/preserveaspectratio/index.html
+++ b/files/en-us/web/api/svgmarkerelement/preserveaspectratio/index.html
@@ -49,14 +49,16 @@ <h3>Value</h3>
</dl>
</dd>
<dt><code>meetOrSlice</code></dt>
- <dl>
- <dt><code>0</code></dt>
- <dd><code>SVG_MEETORSLICE_UNKNOWN</code></dd>
- <dt><code>1</code></dt>
- <dd><code>SVG_MEETORSLICE_MEET</code></dd>
- <dt><code>2</code></dt>
- <dd><code>SVG_MEETORSLICE_SLICE</code></dd>
- </dl>
+ <dd>One of the following numeric constants:
+ <dl>
+ <dt><code>0</code></dt>
+ <dd><code>SVG_MEETORSLICE_UNKNOWN</code></dd>
+ <dt><code>1</code></dt>
+ <dd><code>SVG_MEETORSLICE_MEET</code></dd>
+ <dt><code>2</code></dt>
+ <dd><code>SVG_MEETORSLICE_SLICE</code></dd>
+ </dl>
+ </dd>
</dl>
<h2 id="Examples">Examples</h2>
From 6fa38630e4b3f8875e3fe68cff4cb8ab132595ae Mon Sep 17 00:00:00 2001
From: Will Bamberg <will@bootbonnet.ca>
Date: Mon, 30 Aug 2021 22:17:29 -0700
Subject: [PATCH 2/2] Fix a few stragglers
---
files/en-us/web/api/datatransfer/setdragimage/index.html | 5 +----
files/en-us/web/api/elementinternals/setvalidity/index.html | 6 ++----
files/en-us/web/api/fileentrysync/index.html | 5 +----
files/en-us/web/api/ndefreader/write/index.html | 1 +
4 files changed, 5 insertions(+), 12 deletions(-)
diff --git a/files/en-us/web/api/datatransfer/setdragimage/index.html b/files/en-us/web/api/datatransfer/setdragimage/index.html
index eee165b8b956603..940db25bb10956d 100644
--- a/files/en-us/web/api/datatransfer/setdragimage/index.html
+++ b/files/en-us/web/api/datatransfer/setdragimage/index.html
@@ -49,10 +49,7 @@ <h3 id="Arguments">Arguments</h3>
<h3 id="Return_Value">Return value</h3>
-<dl>
- <dt>void</dt>
- <dd></dd>
-</dl>
+<p>None.</p>
<h2 id="Example">Example</h2>
diff --git a/files/en-us/web/api/elementinternals/setvalidity/index.html b/files/en-us/web/api/elementinternals/setvalidity/index.html
index 08a79c1330015b9..fb5cc11cbab5389 100644
--- a/files/en-us/web/api/elementinternals/setvalidity/index.html
+++ b/files/en-us/web/api/elementinternals/setvalidity/index.html
@@ -24,7 +24,7 @@ <h3 id="Parameters">Parameters</h3>
<dl>
<dt><code>flags</code>{{Optional_Inline}}</dt>
<dd>A dictionary object containing one or more flags indicating the validity state of the element:
- <ul>
+ <dl>
<dt><code>valueMissing</code></dt>
<dd>A boolean value that is <code>true</code> if the element has a {{htmlattrxref("required", "input")}} attribute, but no value, or <code>false</code> otherwise. If <code>true</code>, the element matches the {{cssxref(":invalid")}} CSS pseudo-class.</dd>
<dt><code>typeMismatch</code></dt>
@@ -45,7 +45,7 @@ <h3 id="Parameters">Parameters</h3>
<dd>A boolean value that is <code>true</code> if the user has provided input that the browser is unable to convert.</dd>
<dt><code>customError</code></dt>
<dd>A boolean value indicating whether the element's custom validity message has been set to a non-empty string by calling the element's {{domxref('HTMLObjectElement.setCustomValidity', 'setCustomValidity()')}} method.</dd>
- </ul>
+ </dl>
<div class="notecard note">
<p><strong>Note:</strong> To set all flags to <code>false</code>, indicating that this element passes all constraints validation, pass in an empty object <code>{}</code>. In this case, you do not need to also pass a <code>message</code>.</p>
@@ -89,5 +89,3 @@ <h2 id="Specifications">Specifications</h2>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p>{{Compat}}</p>
-
-
diff --git a/files/en-us/web/api/fileentrysync/index.html b/files/en-us/web/api/fileentrysync/index.html
index e43765635ca0e6c..268bcd04467c382 100644
--- a/files/en-us/web/api/fileentrysync/index.html
+++ b/files/en-us/web/api/fileentrysync/index.html
@@ -92,10 +92,7 @@ <h5 id="Parameter_2">Parameter</h5>
<h5 id="Returns_2">Returns</h5>
-<dl>
- <dt><code>File</code></dt>
- <dd></dd>
-</dl>
+<p>A <code>File</code> object.</p>
<h5 id="Exceptions_2">Exceptions</h5>
diff --git a/files/en-us/web/api/ndefreader/write/index.html b/files/en-us/web/api/ndefreader/write/index.html
index 7d8d31d5b0353a6..291f380e4a9bd20 100644
--- a/files/en-us/web/api/ndefreader/write/index.html
+++ b/files/en-us/web/api/ndefreader/write/index.html
@@ -61,6 +61,7 @@ <h3 id="Parameters">Parameters</h3>
</dd>
<dt><code>options</code> {{optional_inline}}</dt>
<dd>
+ <p>An object with the following properties:</p>
<ul>
<li><code>overwrite</code> -- A {{JSxRef("Boolean")}} specifying whether or not
existing records should be overwritten, if such exists.</li>