fix: MD024 Multiple headings with same content (mdn#20118)

* fix: MD024 Multiple headings with same content * Apply suggestions from code review Co-authored-by: Jean-Yves Perrier <[email protected]> * Update files/en-us/web/css/css_container_queries/index.md Co-authored-by: Jean-Yves Perrier <[email protected]> * fix: Re-add HTML/JavaScript headings Co-authored-by: Jean-Yves Perrier <[email protected]>
merry-degaga · Sep 5, 2022 · 6f2391b · 6f2391b
1 parent 871c718
commit 6f2391b
Show file tree

Hide file tree

Showing 23 changed files with 33 additions and 119 deletions.
diff --git a/.markdownlint.json b/.markdownlint.json
@@ -11,7 +11,9 @@
     "spaces_per_tab": 2
   },
   "MD013": false,
-  "MD024": false,
+  "MD024": {
+    "allow_different_nesting": true
+  },
   "MD025": {
     "front_matter_title": "^\\s*title\\s*[:=]"
   },

diff --git a/files/en-us/games/index.md b/files/en-us/games/index.md
@@ -59,7 +59,4 @@ For a list of web game examples, see our [examples page](/en-US/docs/Games/Examp
   - : JavaScript coding competition for HTML game developers with the file size limit set to 13 kilobytes. All the submitted games are available in a readable form on GitHub.
 - [Mozilla Hacks Blog](https://hacks.mozilla.org/category/games/)
   - : Games category on the Mozilla Hacks blog containing interesting gamedev related articles.
-
-## See also
-
 - [Games section on wiki.mozilla.org](https://wiki.mozilla.org/Platform/Games)
diff --git a/files/en-us/mozilla/firefox/releases/74/index.md b/files/en-us/mozilla/firefox/releases/74/index.md
@@ -76,15 +76,12 @@ _No changes._
 ### Security
 
 - TLS 1.0 and 1.1 support has been removed from Firefox; you'll need to make sure your web server supports TLS 1.2 or 1.3 going forward. From now on, Firefox will return a [Secure Connection Failed](https://support.mozilla.org/en-US/kb/secure-connection-failed-firefox-did-not-connect) error when connecting to servers using the older TLS versions ({{bug(1606734)}}).
+- Starting in Firefox 74, when a site delegates permission to access a resource to embedded content in an {{HTMLElement("iframe")}} using the {{htmlattrxref("allow", "iframe")}} attribute, and the embedded page requests permission to use that resource, the parent page prompts the user for permission to use the resource and share it with the embedded domain, rather than both the outer and inner pages prompting the user for permission. If the outer page doesn't have the permission requested by the `allow` attribute, the `<iframe>` is immediately denied access without prompting the user {{bug(1483631)}}.
 
 ### Plugins
 
 _No changes._
 
-### Security
-
-- Starting in Firefox 74, when a site delegates permission to access a resource to embedded content in an {{HTMLElement("iframe")}} using the {{htmlattrxref("allow", "iframe")}} attribute, and the embedded page requests permission to use that resource, the parent page prompts the user for permission to use the resource and share it with the embedded domain, rather than both the outer and inner pages prompting the user for permission. If the outer page doesn't have the permission requested by the `allow` attribute, the `<iframe>` is immediately denied access without prompting the user {{bug(1483631)}}.
-
 ### WebDriver conformance (Marionette)
 
 - Added `WebDriver:Print` to print the current page as a PDF document ({{bug(1604506)}}).

diff --git a/files/en-us/mozilla/firefox/releases/75/index.md b/files/en-us/mozilla/firefox/releases/75/index.md
@@ -86,10 +86,6 @@ _No changes._
 
 _No changes._
 
-### Security
-
-_No changes._
-
 ### WebDriver conformance (Marionette)
 
 - Fixed a bug that always caused Marionette to initialize when Firefox starts-up. It has been limited to the command line argument and environment variable now ({{bug(1622012)}}).

diff --git a/files/en-us/web/api/element/outerhtml/index.md b/files/en-us/web/api/element/outerhtml/index.md
@@ -46,9 +46,9 @@ descendants with a new DOM tree constructed by parsing the specified
 
 ## Examples
 
-Getting the value of an element's `outerHTML` property:
+### Getting the value of an element's outerHTML property
 
-### HTML
+#### HTML
 
 ```html
 <div id="d">
@@ -57,7 +57,7 @@ Getting the value of an element's `outerHTML` property:
 </div>
 ```
 
-### JavaScript
+#### JavaScript
 
 ```js
 const d = document.getElementById("d");
@@ -67,17 +67,17 @@ console.log(d.outerHTML);
 // is written to the console window
 ```
 
-Replacing a node by setting the `outerHTML` property:
+### Replacing a node by setting the outerHTML property
 
-### HTML
+#### HTML
 
 ```html
 <div id="container">
   <div id="d">This is a div.</div>
 </div>
 ```
 
-### JavaScript
+#### JavaScript
 
 ```js
 const container = document.getElementById("container");

diff --git a/files/en-us/web/api/gamepad/axes/index.md b/files/en-us/web/api/gamepad/axes/index.md
@@ -23,7 +23,7 @@ the axis position from the lowest value (-1.0) to the highest value (1.0).
 
 ## Value
 
-An array.
+An array of numbers.
 
 ## Examples
 
@@ -50,10 +50,6 @@ function gameLoop() {
 };
 ```
 
-## Value
-
-An array of {{domxref("double") }} values.
-
 ## Specifications
 
 {{Specifications}}

diff --git a/files/en-us/web/api/gamepad/buttons/index.md b/files/en-us/web/api/gamepad/buttons/index.md
@@ -82,10 +82,6 @@ function gameLoop() {
 };
 ```
 
-## Value
-
-An array of {{domxref("gamepadButton")}} objects.
-
 ## Specifications
 
 {{Specifications}}

diff --git a/files/en-us/web/api/gamepad/connected/index.md b/files/en-us/web/api/gamepad/connected/index.md
@@ -32,10 +32,6 @@ const gp = navigator.getGamepads()[0];
 console.log(gp.connected);
 ```
 
-## Value
-
-A boolean value.
-
 ## Specifications
 
 {{Specifications}}

diff --git a/files/en-us/web/api/gamepad/id/index.md b/files/en-us/web/api/gamepad/id/index.md
@@ -31,7 +31,7 @@ device as well as display useful feedback to the user.
 
 ## Value
 
-A string.
+A string primitive.
 
 ## Examples
 
@@ -42,10 +42,6 @@ window.addEventListener("gamepadconnected", () => {
 });
 ```
 
-## Value
-
-A {{jsxref("String")}}.
-
 ## Specifications
 
 {{Specifications}}

diff --git a/files/en-us/web/api/gamepad/timestamp/index.md b/files/en-us/web/api/gamepad/timestamp/index.md
@@ -38,10 +38,6 @@ const gp = navigator.getGamepads()[0];
 console.log(gp.timestamp);
 ```
 
-## Value
-
-A {{domxref("DOMHighResTimeStamp")}}.
-
 ## Specifications
 
 {{Specifications}}

diff --git a/files/en-us/web/api/gamepadevent/gamepad/index.md b/files/en-us/web/api/gamepadevent/gamepad/index.md
@@ -33,10 +33,6 @@ window.addEventListener("gamepadconnected", (e) => {
 });
 ```
 
-## Value
-
-A {{domxref("Gamepad")}} object.
-
 ## Specifications
 
 {{Specifications}}

diff --git a/files/en-us/web/api/paymentaddress/tojson/index.md b/files/en-us/web/api/paymentaddress/tojson/index.md
@@ -23,10 +23,6 @@ representation of the PaymentAddress object's properties.
 
 ## Value
 
-None.
-
-## Value
-
 A JSON object.
 
 ## Browser compatibility

diff --git a/files/en-us/web/api/rtcpeerconnection/setlocaldescription/index.md b/files/en-us/web/api/rtcpeerconnection/setlocaldescription/index.md
@@ -51,7 +51,17 @@ setLocalDescription(sessionDescription, successCallback, errorCallback) // depre
 
 ### Return value
 
-A {{jsxref("Promise")}}.
+A {{jsxref("Promise")}} which is fulfilled once the value of
+{{domxref("RTCPeerConnection.localDescription")}} is successfully changed or rejected if
+the change cannot be applied (for example, if the specified description is incompatible
+with one or both of the peers on the connection). The promise's fulfillment handler
+receives no input parameters.
+
+> **Note:** The process of changing descriptions actually involves intermediary steps handled by
+> the WebRTC layer to ensure that an active connection can be changed without losing the
+> connection if the change does not succeed. See
+> {{SectionOnPage("/en-US/docs/Web/API/WebRTC_API/Connectivity", "Pending and current
+    descriptions")}} for more details on this process.
 
 #### Implicit description
 
@@ -83,20 +93,6 @@ myPeerConnection.createOffer()
 For this reason, the {{domxref("RTCSessionDescription.RTCSessionDescription",
   "RTCSessionDescription()")}} constructor is deprecated.
 
-### Return value
-
-A {{jsxref("Promise")}} which is fulfilled once the value of
-{{domxref("RTCPeerConnection.localDescription")}} is successfully changed or rejected if
-the change cannot be applied (for example, if the specified description is incompatible
-with one or both of the peers on the connection). The promise's fulfillment handler
-receives no input parameters.
-
-> **Note:** The process of changing descriptions actually involves intermediary steps handled by
-> the WebRTC layer to ensure that an active connection can be changed without losing the
-> connection if the change does not succeed. See
-> {{SectionOnPage("/en-US/docs/Web/API/WebRTC_API/Connectivity", "Pending and current
-    descriptions")}} for more details on this process.
-
 ### Deprecated parameters
 
 In older code and documentation, you may see a callback-based version of this function

diff --git a/files/en-us/web/api/screen_capture_api/using_screen_capture/index.md b/files/en-us/web/api/screen_capture_api/using_screen_capture/index.md
@@ -132,10 +132,6 @@ Capturing audio is always optional, and even when web content requests a stream
 
 The {{jsxref("promise")}} returned by {{domxref("MediaDevices.getDisplayMedia", "getDisplayMedia()")}} resolves to a {{domxref("MediaStream")}} that contains at least one video stream that contains the screen or screen area, and which is adjusted or filtered based upon the constraints specified when `getDisplayMedia()` was called.
 
-## Security
-
-As is always the case when sharing content over a network, it's important to consider the privacy and safety implications of screen sharing.
-
 ### Potential risks
 
 Privacy and security issues surrounding screen sharing are usually not overly serious, but they do exist. The largest potential issue is users inadvertently sharing content they did not wish to share.

diff --git a/files/en-us/web/api/serviceworkerglobalscope/fetch_event/index.md b/files/en-us/web/api/serviceworkerglobalscope/fetch_event/index.md
@@ -34,12 +34,6 @@ onfetch = (event) => {};
 
 A generic {{domxref("Event")}}.
 
-## Syntax
-
-```js
-serviceWorkerGlobalScope.onfetch = (fetchEvent) => { /* … */ }
-```
-
 ## Example
 
 This code snippet is from the [service worker prefetch sample](https://github.com/GoogleChrome/samples/blob/gh-pages/service-worker/prefetch/service-worker.js) (see [prefetch example live](https://googlechrome.github.io/samples/service-worker/prefetch/).) The {{domxref("ServiceWorkerGlobalScope.fetch_event", "onfetch")}} event handler

diff --git a/files/en-us/web/api/web_audio_api/simple_synth/index.md b/files/en-us/web/api/web_audio_api/simple_synth/index.md
@@ -513,7 +513,7 @@ Then we get the type of waveform to use by checking the value of the waveform pi
 
 The oscillator's frequency is set to the value specified in the `freq` parameter by setting the value of the {{domxref("Oscillator.frequency")}} {{domxref("AudioParam")}} object. Then, at last, the oscillator is started up so that it begins to produce sound by calling the oscillator's inherited {{domxref("AudioScheduledSourceNode.start()")}} method.
 
-#### Playing a tone
+#### Playing a note
 
 When the {{domxref("Element/mousedown_event", "mousedown")}} or {{domxref("Element/mouseover_event", "mouseover")}} event occurs on a key, we want to start playing the corresponding note. The `notePressed()` function is used as the event handler for these events.
 

diff --git a/files/en-us/web/api/xrsession/requestreferencespace/index.md b/files/en-us/web/api/xrsession/requestreferencespace/index.md
@@ -42,6 +42,8 @@ requestReferenceSpace(referenceSpaceType)
 
 ### Return value
 
+A {{JSxRef("Promise")}} that resolves with an {{DOMxRef("XRReferenceSpace")}} object.
+
 The types of reference space are listed below, with brief information about their use cases and which interface is used to implement them.
 
 - `bounded-floor`
@@ -55,10 +57,6 @@ The types of reference space are listed below, with brief information about thei
 - `viewer`
   - : An {{domxref("XRReferenceSpace")}} tracking space whose native origin tracks the viewer's position and orientation. This is used for environments in which the user can physically move around, and is supported by all instances of {{domxref("XRSession")}}, both immersive and inline, though it's most useful for inline sessions. It's particularly useful when determining the distance between the viewer and an input, or when working with offset spaces. Otherwise, typically, one of the other reference space types will be used more often.
 
-### Return value
-
-A {{JSxRef("Promise")}} that resolves with an {{DOMxRef("XRReferenceSpace")}} object.
-
 ### Exceptions
 
 Rather than throwing true exceptions, `requestReferenceSpace()` rejects the

diff --git a/files/en-us/web/api/xrview/requestviewportscale/index.md b/files/en-us/web/api/xrview/requestviewportscale/index.md
@@ -23,18 +23,16 @@ The **`requestViewportScale()`** method of the {{domxref("XRView")}} interface r
 requestViewportScale(scale)
 ```
 
-### Parameters
+## Parameters
 
 - `scale`
   - : A number greater than 0.0 and less than or equal to 1.0 representing the scale factor.
 
-### Return value
+## Return value
 
 None ({{jsxref("undefined")}}).
 
-## Examples
-
-### Dynamic viewport scaling
+## Dynamic viewport scaling
 
 Dynamic viewport scaling allows applications to only use a subset of the available {{domxref("XRWebGLLayer.framebuffer", "framebuffer")}}. The feature may not be available on all systems since it depends on driver support, so you might want to ensure that `requestViewportScale()` exists before calling it.
 

diff --git a/files/en-us/web/css/css_box_model/introduction_to_the_css_box_model/index.md b/files/en-us/web/css/css_box_model/introduction_to_the_css_box_model/index.md
@@ -42,18 +42,15 @@ The size of the margin area is determined by the {{cssxref("margin-top")}}, {{cs
 
 Finally, note that for non-replaced inline elements, the amount of space taken up (the contribution to the height of the line) is determined by the {{cssxref('line-height')}} property, even though the borders and padding are still displayed around the content.
 
-## See also
-
-- [Layout and the containing block](/en-US/docs/Web/CSS/Containing_block)
-- [Introducing the CSS Cascade](/en-US/docs/Web/CSS/Cascade)
-- [Cascade and inheritance](/en-US/docs/Learn/CSS/Building_blocks/Cascade_and_inheritance)
-
 ## Specifications
 
 {{Specifications}}
 
 ## See also
 
+- [Layout and the containing block](/en-US/docs/Web/CSS/Containing_block)
+- [Introducing the CSS Cascade](/en-US/docs/Web/CSS/Cascade)
+- [Cascade and inheritance](/en-US/docs/Learn/CSS/Building_blocks/Cascade_and_inheritance)
 - CSS key concepts:
   - [CSS syntax](/en-US/docs/Web/CSS/Syntax)
   - [At-rules](/en-US/docs/Web/CSS/At-rule)

diff --git a/files/en-us/web/css/css_container_queries/index.md b/files/en-us/web/css/css_container_queries/index.md
@@ -44,7 +44,7 @@ In addition the draft specification proposes some new properties:
 - `container`:
   - : A shorthand property to set both `container-type` and `container-name`.
 
-### `container-type`
+### The container-type property
 
 The `container-type` property can have the following values:
 

diff --git a/files/en-us/web/css/repeat/index.md b/files/en-us/web/css/repeat/index.md
@@ -52,8 +52,6 @@ repeat(4, [col-start] fit-content(200px) [col-end])
 repeat(4, 10px [col-start] 30% [col-middle] 400px [col-end])
 ```
 
-## Syntax
-
 The `repeat()` function takes two arguments:
 
 - **repeat count**: the first argument specifies the number of times that the track list should be repeated. It is specified with an integer value of 1 or more, or with the keyword values [`auto-fill`](#auto-fill) or [`auto-fit`](#auto-fit). These keyword values repeat the set of tracks as many times as is needed to fill the grid container.

diff --git a/files/en-us/web/html/element/title/index.md b/files/en-us/web/html/element/title/index.md
@@ -121,8 +121,6 @@ A common navigation technique for users of assistive technology is to read the p
 
 If a form submission contains errors and the submission re-renders the current page, the title can be used to help make users aware of any errors with their submission. For instance, update the page `title` value to reflect significant page state changes (such as form validation problems).
 
-### Example
-
 ```html
 <title>2 errors - Your order - Blue House Chinese Food - FoodYum: Online takeout today!</title>
 ```

diff --git a/files/en-us/web/svg/attribute/fx/index.md b/files/en-us/web/svg/attribute/fx/index.md
@@ -66,31 +66,6 @@ html, body, svg {
   </tbody>
 </table>
 
-## Example
-
-```html
-<svg viewBox="0 0 120 120" width="200" height="200" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <radialGradient id="Gradient" cx="0.5" cy="0.5" r="0.5"
-        fx="0.35" fy="0.35" fr="5%">
-      <stop offset="0%" stop-color="red"/>
-      <stop offset="100%" stop-color="blue"/>
-    </radialGradient>
-  </defs>
-
-  <rect x="10" y="10" rx="15" ry="15" width="100" height="100"
-      fill="url(#Gradient)" stroke="black" stroke-width="2"/>
-
-  <circle cx="60" cy="60" r="50" fill="transparent" stroke="white" stroke-width="2"/>
-  <circle cx="45" cy="45" r="2" fill="white" stroke="white"/>
-  <circle cx="60" cy="60" r="2" fill="white" stroke="white"/>
-  <text x="38" y="40" fill="white" font-family="sans-serif" font-size="10pt">(fx,fy)</text>
-  <text x="63" y="63" fill="white" font-family="sans-serif" font-size="10pt">(cx,cy)</text>
-</svg>
-```
-
-{{EmbedLiveSample("Example", "200", "200")}}
-
 ## Specifications
 
 {{Specifications}}
-Original file line number
+Diff line change
@@ Expand Up @@
     If a form submission contains errors and the submission re-renders the current page, the title can be used to help make users aware of any errors with their submission. For instance, update the page `title` value to reflect significant page state changes (such as form validation problems).
-    ### Example
     ```html
     <title>2 errors - Your order - Blue House Chinese Food - FoodYum: Online takeout today!</title>
     ```
@@ Expand Down @@