Merge branch 'main' into patch-4

ramiy · Sep 8, 2024 · dbefdb1 · dbefdb1
2 parents 4093dd2 + 11b7591
commit dbefdb1
Show file tree

Hide file tree

Showing 30 changed files with 202 additions and 156 deletions.
diff --git a/.github/workflows/spelling-check-bot.yml b/.github/workflows/spelling-check-bot.yml
@@ -24,25 +24,33 @@ jobs:
           npm install
           echo Running spelling check...
           output=$(npx cspell --no-progress --gitignore --config .vscode/cspell.json "**/*.md" || exit 0)
+          output=$(node scripts/linkify-logs.js "${output}")
+          output=$(echo "$output" | sed 's/^/- /')
           echo "$output"
           echo "OUTPUT<<EOF" >> $GITHUB_ENV
           echo "$output" >> $GITHUB_ENV
           echo "EOF" >> $GITHUB_ENV
 
-      - name: Create an issue
+      - name: Report spellcheck errors
         if: env.OUTPUT != ''
-        uses: dacbd/create-issue-action@main
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          title: Weekly spelling check
-          body: |
-            Typos and unknown words:
-
-            ```
-            ${{ env.OUTPUT }}
-            ```
-
-            > [!TIP]
-            > To exclude words from the spellchecker, you can add valid words (web technology terms or abbreviations) to the [terms-abbreviations.txt](https://github.com/mdn/content/blob/main/.vscode/terms-abbreviations.txt) dictionary for IDE autocompletion. To ignore strings that are not words (`AABBCC` in code, for instance), you can add them to [ignore-list.txt](https://github.com/mdn/content/blob/main/.vscode/ignore-list.txt).
+        run: |
+          comment_body=$(cat<<EOM
+          Typos and unknown words:
+
+          ${OUTPUT}
+
+          > [!TIP]
+          > To exclude words from the spellchecker, you can add valid words (web technology terms or abbreviations) to the [terms-abbreviations.txt](https://github.com/mdn/content/blob/main/.vscode/terms-abbreviations.txt) dictionary for IDE autocompletion. To ignore strings that are not words (\`AABBCC\` in code, for instance), you can add them to [ignore-list.txt](https://github.com/mdn/content/blob/main/.vscode/ignore-list.txt).
+          EOM
+          )
+          comment_body+=$'\n\n'$(echo "_(comment last updated: $(date +'%Y-%m-%d %H:%M:%S'))_")
+          gh api \
+            --method PATCH \
+            -H "Accept: application/vnd.github+json" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            /repos/mdn/content/issues/35634 \
+            -f "state=open" \
+            -f "body=${comment_body}"
         env:
           OUTPUT: ${{ env.OUTPUT }}
+          GH_TOKEN: ${{ github.token }}
diff --git a/files/en-us/learn/forms/html5_input_types/search_focus.png b/files/en-us/learn/forms/html5_input_types/search_focus.png
diff --git a/files/en-us/learn/index.md b/files/en-us/learn/index.md
@@ -76,7 +76,7 @@ There are patterns that make it easier to find these resources, for example:
 ## Getting our code examples
 
 The code examples you'll encounter in the Learning Area are all [available on GitHub](https://github.com/mdn/learning-area/).
-If you want to copy them all to your computer, the easiest way is to [download a ZIP of the latest master code branch](https://codeload.github.com/mdn/learning-area/zip/main).
+If you want to copy them all to your computer, the easiest way is to [download a ZIP of the latest main code branch](https://codeload.github.com/mdn/learning-area/zip/main).
 
 If you prefer to copy the repo in a more flexible way that allows for automatic updates, you can follow the more complex instructions:
 
@@ -90,7 +90,7 @@ If you prefer to copy the repo in a more flexible way that allows for automatic
 
 4. You can now enter the directory and find the files you are after (either using your Finder/File Explorer or the [`cd` command](<https://en.wikipedia.org/wiki/Cd_(command)>)).
 
-You can update the `learning-area` repository with any changes made to the master version on GitHub with the following steps:
+You can update the `learning-area` repository with any changes made to the main version on GitHub with the following steps:
 
 1. In your command prompt/terminal, go inside the `learning-area` directory using `cd`. For example, if you were in the parent directory:
 

diff --git a/files/en-us/learn/javascript/building_blocks/looping_code/index.md b/files/en-us/learn/javascript/building_blocks/looping_code/index.md
@@ -619,7 +619,7 @@ If you get really stuck, press "Show solution" to see a solution.
   Press Esc to move focus away from the code area (Tab inserts a tab character).
 </p>
 <textarea id="code" class="playable-code" style="height: 300px;width: 95%">
-let output = document.querySelector('.output');
+const output = document.querySelector('.output');
 output.textContent = "";
 
 // let i = 10;

diff --git a/files/en-us/mozilla/firefox/experimental_features/index.md b/files/en-us/mozilla/firefox/experimental_features/index.md
@@ -2070,48 +2070,6 @@ Notifications have the [`requireInteraction`](/en-US/docs/Web/API/Notification/r
   </tbody>
 </table>
 
-### Web Codecs API
-
-The [Web Codecs API](/en-US/docs/Web/API/WebCodecs_API) gives web developers low-level access to the individual frames of a video stream and chunks of audio.
-The following interfaces are supported (on Linux desktop only): [`VideoEncoder`](/en-US/docs/Web/API/VideoEncoder), [`VideoDecoder`](/en-US/docs/Web/API/VideoDecoder), [`EncodedVideoChunk`](/en-US/docs/Web/API/EncodedVideoChunk), [`VideoFrame`](/en-US/docs/Web/API/VideoFrame), [`VideoColorSpace`](/en-US/docs/Web/API/VideoColorSpace).
-([Firefox bug 1874445](https://bugzil.la/1874445)).
-
-<table>
-  <thead>
-    <tr>
-      <th>Release channel</th>
-      <th>Version changed</th>
-      <th>Enabled by default?</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <th>Nightly</th>
-      <td>123</td>
-      <td>Yes. Linux desktop only.</td>
-    </tr>
-    <tr>
-      <th>Developer Edition</th>
-      <td>123</td>
-      <td>No</td>
-    </tr>
-    <tr>
-      <th>Beta</th>
-      <td>123</td>
-      <td>No</td>
-    </tr>
-    <tr>
-      <th>Release</th>
-      <td>123</td>
-      <td>No</td>
-    </tr>
-    <tr>
-      <th>Preference name</th>
-      <td colspan="2"><code>dom.media.webcodecs.enabled</code></td>
-    </tr>
-  </tbody>
-</table>
-
 ## Security and privacy
 
 ### Block plain text requests from Flash on encrypted pages

diff --git a/files/en-us/mozilla/firefox/releases/130/index.md b/files/en-us/mozilla/firefox/releases/130/index.md
@@ -23,6 +23,7 @@ This article provides information about the changes in Firefox 130 that affect d
 ### APIs
 
 - The [X25519](/en-US/docs/Web/API/SubtleCrypto/deriveKey#x25519) digital signature algorithm is supported by the [Web Crypto API](/en-US/docs/Web/API/Web_Crypto_API), and can be used in the {{domxref("SubtleCrypto")}} methods: {{domxref("SubtleCrypto.deriveKey()", "deriveKey()")}}, {{domxref("SubtleCrypto.deriveBits()", "deriveBits()")}}, {{domxref("SubtleCrypto.generateKey()", "generateKey()")}}, {{domxref("SubtleCrypto.importKey()", "importKey()")}} and {{domxref("SubtleCrypto.exportKey()", "exportKey()")}} ([Firefox bug 1904836](https://bugzil.la/1904836)).
+- The [Web Codecs API](/en-US/docs/Web/API/WebCodecs_API) is supported on desktop releases, giving web developers low-level access to the individual frames of a video stream and chunks of audio. Android support is enabled in the Nightly release. The new interfaces include: [`VideoEncoder`](/en-US/docs/Web/API/VideoEncoder), [`VideoDecoder`](/en-US/docs/Web/API/VideoDecoder), [`EncodedVideoChunk`](/en-US/docs/Web/API/EncodedVideoChunk), [`VideoFrame`](/en-US/docs/Web/API/VideoFrame), and [`VideoColorSpace`](/en-US/docs/Web/API/VideoColorSpace). ([Firefox bug 1908572](https://bugzil.la/1908572)).
 
 #### Removals
 

diff --git a/files/en-us/web/api/blob/bytes/index.md b/files/en-us/web/api/blob/bytes/index.md
@@ -35,5 +35,3 @@ The method will reject the returned {{jsxref("Promise")}} if, for example, the r
 ## Browser compatibility
 
 {{Compat}}
-
-## See also
diff --git a/files/en-us/web/api/filesystemhandle/querypermission/index.md b/files/en-us/web/api/filesystemhandle/querypermission/index.md
@@ -32,14 +32,13 @@ queryPermission(descriptor)
 
 ### Return value
 
-{{domxref('PermissionStatus.state')}} which is one of `'granted'`,
-`'denied'` or `'prompt'`.
+A {{jsxref("Promise")}} that resolves with {{domxref('PermissionStatus.state')}} which is one of `'granted'`, `'denied'` or `'prompt'`. It may also reject with one of the exceptions below.
 
-If this returns "prompt" the website will have to call `requestPermission()` before any
-operations on the handle can be done. If this returns "denied" any operations will
+If this resolves with "prompt", the website will have to call `requestPermission()` before any
+operations on the handle can be done. If this resolves with "denied" any operations will
 reject. Usually handles returned by the local file system handle factories will
-initially return "granted" for their read permission state. However, other than through
-the user revoking permission, a handle retrieved from IndexedDB is also likely to return
+initially resolves with "granted" for their read permission state. However, other than through
+the user revoking permission, a handle retrieved from IndexedDB is also likely to resolves with
 "prompt".
 
 ### Exceptions

diff --git a/files/en-us/web/api/htmlinputelement/webkitdirectory/index.md b/files/en-us/web/api/htmlinputelement/webkitdirectory/index.md
@@ -15,7 +15,7 @@ When a directory is selected, the directory and its entire hierarchy of contents
 The selected file system entries can be obtained using the {{domxref("HTMLInputElement.webkitEntries", "webkitEntries")}} property.
 
 > [!NOTE]
-> This property is called `webkitEntries` in the specification due to its
+> This property is called `webkitdirectory` in the specification due to its
 > origins as a Google Chrome-specific API. It's likely to be renamed someday.
 
 ## Value

diff --git a/files/en-us/web/api/navigator/registerprotocolhandler/protocolregister.png b/files/en-us/web/api/navigator/registerprotocolhandler/protocolregister.png
diff --git a/files/en-us/web/api/wheelevent/wheelevent/index.md b/files/en-us/web/api/wheelevent/wheelevent/index.md
@@ -27,7 +27,9 @@ new WheelEvent(type, options)
   - : A string with the name of the event.
     It is case-sensitive and browsers always set it to `wheel`.
 - `options` {{optional_inline}}
+
   - : An object that, _in addition of the properties defined in {{domxref("MouseEvent/MouseEvent", "MouseEvent()")}}_, can have the following properties:
+
     - `deltaX` {{optional_inline}}
       - : A floating number representing the horizontal scroll amount in the `deltaMode` unit.
         It defaults to `0.0`.
@@ -38,12 +40,14 @@ new WheelEvent(type, options)
       - : A floating number representing the scroll amount for the z-axis scroll amount in the `deltaMode` unit.
         It defaults to `0.0`.
     - `deltaMode` {{optional_inline}}
+
       - : An integer representing the unit of the delta values scroll amount. It defaults to `0x00`. Permitted values are:
-        | Constant | Value | Description |
+
+        | Constant          | Value  | Description                               |
         | ----------------- | ------ | ----------------------------------------- |
         | `DOM_DELTA_PIXEL` | `0x00` | The delta values are specified in pixels. |
-        | `DOM_DELTA_LINE` | `0x01` | The delta values are specified in lines. |
-        | `DOM_DELTA_PAGE` | `0x02` | The delta values are specified in pages. |
+        | `DOM_DELTA_LINE`  | `0x01` | The delta values are specified in lines.  |
+        | `DOM_DELTA_PAGE`  | `0x02` | The delta values are specified in pages.  |
 
 ### Return value
 

diff --git a/files/en-us/web/api/xmlhttprequest/send/index.md b/files/en-us/web/api/xmlhttprequest/send/index.md
@@ -39,7 +39,7 @@ send(body)
   - : A body of data to be sent in the XHR request. This can be:
 
     - A {{domxref("Document")}}, in which case it is serialized before being sent.
-    - An `XMLHttpRequestBodyInit`, which [per the Fetch spec](https://fetch.spec.whatwg.org/#typedefdef-xmlhttprequestbodyinit) can be a {{domxref("Blob")}}, an {{jsxref("ArrayBuffer")}}, a {{jsxref("TypedArray")}}, a {{jsxref("DataView")}}, a {{domxref("FormData")}}, a {{domxref("URLSearchParams")}}, or a string literal or object.
+    - An `XMLHttpRequestBodyInit`, which [per the Fetch spec](https://fetch.spec.whatwg.org/#typedefdef-xmlhttprequestbodyinit) can be a {{domxref("Blob")}}, an {{jsxref("ArrayBuffer")}}, a {{jsxref("TypedArray")}}, a {{jsxref("DataView")}}, a {{domxref("FormData")}}, a {{domxref("URLSearchParams")}}, or a string.
     - `null`
 
     If no value is specified for the body, a default value of `null` is used.

diff --git a/files/en-us/web/css/basic-shape/polygon/index.md b/files/en-us/web/css/basic-shape/polygon/index.md
@@ -14,7 +14,6 @@ The **`polygon()`** [CSS](/en-US/docs/Web/CSS) function is one of the {{cssxref(
 ## Syntax
 
 ```css-nolint
-
 /* Specified as coordinate list */
 /* polygon(<length-percentage> <length-percentage>, ... )*/
 polygon(50% 2.4%, 34.5% 33.8%, 0% 38.8%, 25% 63.1%, 19.1% 97.6%)
@@ -52,10 +51,11 @@ The `polygon()` function accepts comma-separated coordinates or points as its va
 <code>polygon(x<sub>1</sub> y<sub>1</sub>, x<sub>2</sub> y<sub>2</sub>, x<sub>3</sub> y<sub>3</sub>, x<sub>4</sub> y<sub>4</sub>, x<sub>n</sub> y<sub>n</sub>)</code>
 
 Given the above, mapping the coordinates of the container can be visualized as:
-| axis | point 1 | point 2 | point 3 | point 4 | point n |
+
+| axis | point 1 | point 2 | point 3 | point 4 | point n       |
 | ---- | ------- | ------- | ------- | ------- | ------------- |
-| x | 0% | 100% | 100% | 0% | x<sub>n</sub> |
-| y | 0% | 0% | 100% | 100% | y<sub>n</sub> |
+| x    | 0%      | 100%    | 100%    | 0%      | x<sub>n</sub> |
+| y    | 0%      | 0%      | 100%    | 100%    | y<sub>n</sub> |
 
 Applying those coordinates to the CSS {{cssxref("clip-path")}} property using the `polygon()` function:
 

diff --git a/files/en-us/web/css/css_functions/index.md b/files/en-us/web/css/css_functions/index.md
@@ -288,7 +288,7 @@ The following functions are used as a value of properties to reference a value d
 
 The following functions are used to define a [CSS grid](/en-US/docs/Web/CSS/CSS_grid_layout).
 
-- {{CSSxRef("fit-content", "fit-content()")}}
+- {{CSSxRef("fit-content_function", "fit-content()")}}
   - : Clamps a given size to an available size according to the formula `min(maximum size, max(minimum size, argument))`.
 - {{CSSxRef("minmax", "minmax()")}}
   - : Defines a size range greater-than or equal-to _min_ and less-than or equal-to _max_.

diff --git a/files/en-us/web/html/attributes/max/index.md b/files/en-us/web/html/attributes/max/index.md
@@ -51,14 +51,14 @@ If the value exceeds the max value allowed, the {{domxref('validityState.rangeOv
     </tr>
     <tr>
       <td>{{HTMLElement("input/time", "time")}}</td>
-      <td><code>hh:mm</code></td>
+      <td><code>HH:mm</code></td>
       <td><code>&#x3C;input type="time" max="17:00" step="900"></code></td>
     </tr>
     <tr>
       <td>
         {{HTMLElement("input/datetime-local", "datetime-local")}}
       </td>
-      <td><code>yyyy-mm-ddThh:mm</code></td>
+      <td><code>yyyy-mm-ddTHH:mm</code></td>
       <td>
         <code>&#x3C;input type="datetime-local" max="2019-12-25T23:59"></code>
       </td>

diff --git a/files/en-us/web/html/attributes/min/index.md b/files/en-us/web/html/attributes/min/index.md
@@ -50,14 +50,14 @@ It is valid for the input types including: {{HTMLElement("input/date", "date")}}
     </tr>
     <tr>
       <td>{{HTMLElement("input/time", "time")}}</td>
-      <td><code>hh:mm</code></td>
+      <td><code>HH:mm</code></td>
       <td><code>&#x3C;input type="time" min="09:00" step="900"></code></td>
     </tr>
     <tr>
       <td>
         {{HTMLElement("input/datetime-local", "datetime-local")}}
       </td>
-      <td><code>yyyy-mm-ddThh:mm</code></td>
+      <td><code>yyyy-mm-ddTHH:mm</code></td>
       <td>
         <code>&#x3C;input type="datetime-local" min="2019-12-25T19:30"></code>
       </td>

diff --git a/files/en-us/web/html/element/heading_elements/index.md b/files/en-us/web/html/element/heading_elements/index.md
@@ -60,7 +60,35 @@ A common navigation technique for users of screen reading software is to quickly
 
 #### Nesting
 
-Headings may be nested as subsections to reflect the organization of the content of the page. Most screen readers can also generate an ordered list of all the headings on a page, which can help a person quickly determine the hierarchy of the content:
+Headings may be nested as subsections to reflect the organization of the content of the page. Most screen readers can also generate an ordered list of all the headings on a page, which can help a person quickly determine the content hierarchy and navigate to different headings.
+
+Given the following page structure:
+
+```html
+<h1>Beetles</h1>
+
+<h2>Etymology</h2>
+
+<h2>Distribution and Diversity</h2>
+
+<h2>Evolution</h2>
+<h3>Late Paleozoic</h3>
+<h3>Jurassic</h3>
+<h3>Cretaceous</h3>
+<h3>Cenozoic</h3>
+
+<h2>External Morphology</h2>
+<h3>Head</h3>
+<h4>Mouthparts</h4>
+<h3>Thorax</h3>
+<h4>Prothorax</h4>
+<h4>Pterothorax</h4>
+<h3>Legs</h3>
+<h3>Wings</h3>
+<h3>Abdomen</h3>
+```
+
+Screen readers would generate a list like this:
 
 1. `h1` Beetles
 

diff --git a/files/en-us/web/html/element/input/datetime-local/index.md b/files/en-us/web/html/element/input/datetime-local/index.md
@@ -32,7 +32,7 @@ You can set a default value for the input by including a date and time inside th
 
 {{ EmbedLiveSample('Value', 600, 60) }}
 
-One thing to note is that the displayed date and time formats differ from the actual `value`; the displayed date and time are formatted according to the user's locale as reported by their operating system, whereas the date/time `value` is always formatted `YYYY-MM-DDThh:mm`. When the above value is submitted to the server, for example, it will look like `partydate=2024-06-01T08:30`.
+One thing to note is that the displayed date and time formats differ from the actual `value`; the displayed date and time are formatted according to the user's locale as reported by their operating system, whereas the date/time `value` is always formatted `YYYY-MM-DDTHH:mm`. When the above value is submitted to the server, for example, it will look like `partydate=2024-06-01T08:30`.
 
 > [!NOTE]
 > Also bear in mind that if such data is submitted via HTTP [`GET`](/en-US/docs/Web/HTTP/Methods/GET), the colon character will need to be escaped for inclusion in the URL parameters, e.g. `partydate=2024-06-01T08%3A30`. See {{jsxref("Global_Objects/encodeURI", "encodeURI()")}} for one way to do this.
@@ -50,13 +50,13 @@ In addition to the attributes common to all {{HTMLElement("input")}} elements, `
 
 ### max
 
-The latest date and time to accept. If the [`value`](/en-US/docs/Web/HTML/Element/input#value) entered into the element is later than this timestamp, the element fails [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). If the value of the `max` attribute isn't a valid string that follows the format `YYYY-MM-DDThh:mm`, then the element has no maximum value.
+The latest date and time to accept. If the [`value`](/en-US/docs/Web/HTML/Element/input#value) entered into the element is later than this timestamp, the element fails [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). If the value of the `max` attribute isn't a valid string that follows the format `YYYY-MM-DDTHH:mm`, then the element has no maximum value.
 
 This value must specify a date string later than or equal to the one specified by the `min` attribute.
 
 ### min
 
-The earliest date and time to accept; timestamps earlier than this will cause the element to fail [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). If the value of the `min` attribute isn't a valid string that follows the format `YYYY-MM-DDThh:mm`, then the element has no minimum value.
+The earliest date and time to accept; timestamps earlier than this will cause the element to fail [constraint validation](/en-US/docs/Web/HTML/Constraint_validation). If the value of the `min` attribute isn't a valid string that follows the format `YYYY-MM-DDTHH:mm`, then the element has no minimum value.
 
 This value must specify a date string earlier than or equal to the one specified by the `max` attribute.
 
@@ -168,7 +168,7 @@ input:valid + span::after {
 > HTML form validation is _not_ a substitute for scripts that ensure that the entered data is in the proper format. It's far too easy for someone to make adjustments to the HTML that allow them to bypass the validation, or to remove it entirely. It's also possible for someone to bypass your HTML entirely and submit the data directly to your server. If your server-side code fails to validate the data it receives, problems can arise when improperly-formatted data is submitted (or data that is too large, is of the wrong type, and so forth).
 
 > [!NOTE]
-> With a `datetime-local` input, the date value is always normalized to the format `YYYY-MM-DDThh:mm`.
+> With a `datetime-local` input, the date value is always normalized to the format `YYYY-MM-DDTHH:mm`.
 
 ## Examples
Original file line number	Diff line number	Diff line change
Expand Up		@@ -35,5 +35,3 @@ The method will reject the returned {{jsxref("Promise")}} if, for example, the r
		## Browser compatibility

		{{Compat}}

		## See also