Merge branch 'main' into shared-storage-api

mdn · Jul 24, 2023 · ce9e2d1 · ce9e2d1
2 parents 1928e17 + d479333
commit ce9e2d1
Show file tree

Hide file tree

Showing 320 changed files with 2,905 additions and 1,432 deletions.
diff --git a/.github/labeler.yml b/.github/labeler.yml
@@ -1,3 +1,15 @@
+system:
+  - package.json
+  - yarn.lock
+  - .github/**/*
+  - .husky/**/*
+  - .vscode/**/*
+  - .*
+  - scripts/**/*
+  - tests/**/*
+  - jest.config.json
+  - front-matter-config.json
+
 Content:Accessibility:
   - files/en-us/web/accessibility/**/*
 Content:CSS:

diff --git a/.github/workflows/markdown-lint-fix.yml b/.github/workflows/markdown-lint-fix.yml
@@ -28,6 +28,7 @@ jobs:
 
       - name: Lint markdown files
         run: |
+          yarn content fix-flaws
           yarn fix:md
           yarn fix:fm
 

diff --git a/.markdownlint-cli2.jsonc b/.markdownlint-cli2.jsonc
@@ -1,35 +1,38 @@
+// This file defines our configuration for Markdownlint. See
+// https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+// for more details on each rule.
+
 {
   "config": {
     "default": true,
-    // MD001 - Heading levels should only increment by one level at a time.
-    // -> Disabled, as some callouts include headings.
-    "MD001": false,
-    "MD004": {
+    // Disabled, as some callouts include headings.
+    "header-increment": false,
+    "ul-style": {
       "style": "dash"
     },
-    "MD007": {
+    "ul-indent": {
       "indent": 2
     },
-    "MD010": {
+    "no-hard-tabs": {
       "spaces_per_tab": 2
     },
-    "MD013": false,
-    "MD024": {
+    "line-length": false,
+    "no-duplicate-header": {
       "allow_different_nesting": true
     },
-    "MD025": {
+    "single-title": {
       "front_matter_title": "^\\s*title\\s*[:=]"
     },
-    "MD026": {
+    "no-trailing-punctuation": {
       "punctuation": ".,;:"
     },
     // Consecutive Notes/Callouts currently don't conform with this rule
-    "MD028": false,
+    "no-blanks-blockquote": false,
     // Force ordered numbering to catch accidental list ending from indenting
-    "MD029": {
+    "ol-prefix": {
       "style": "ordered"
     },
-    "MD033": {
+    "no-inline-html": {
       "allowed_elements": [
         "a",
         "abbr",
@@ -100,24 +103,25 @@
         "var"
       ]
     },
-    "MD034": false,
+    "no-bare-urls": false,
     // Produces too many false positives
-    "MD037": false,
-    "MD040": false,
+    "no-space-in-emphasis": false,
+    "fenced-code-language": false,
     // See https://github.com/mdn/content/pull/20026, as macros currently break this
-    "MD042": false,
-    "MD046": {
+    "no-empty-links": false,
+    "code-block-style": {
       "style": "fenced"
     },
-    "MD049": {
+    "emphasis-style": {
       "style": "underscore"
     },
-    "MD050": {
+    "strong-style": {
       "style": "asterisk"
     },
-    // MD051 - Link fragments should be valid.
-    // -> Disabled, as yari generates link fragments by replacing spaces with underscores, not dashes.
-    "MD051": false,
+    // Disabled, as yari generates link fragments by replacing spaces with underscores, not dashes.
+    "link-fragments": false,
+
+    // https://github.com/OnkarRuikar/markdownlint-rule-search-replace
     "search-replace": {
       "rules": [
         {

diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt
@@ -380,7 +380,7 @@
 /en-US/docs/CSS/:-moz-broken	/en-US/docs/Web/CSS/:-moz-broken
 /en-US/docs/CSS/:-moz-drag-over	/en-US/docs/Web/CSS/:-moz-drag-over
 /en-US/docs/CSS/:-moz-first-node	/en-US/docs/Web/CSS/:-moz-first-node
-/en-US/docs/CSS/:-moz-focusring	/en-US/docs/Web/CSS/:-moz-focusring
+/en-US/docs/CSS/:-moz-focusring	/en-US/docs/Web/CSS/:focus-visible
 /en-US/docs/CSS/:-moz-full-screen	/en-US/docs/Web/CSS/:fullscreen
 /en-US/docs/CSS/:-moz-handler-blocked	/en-US/docs/Web/CSS/:-moz-handler-blocked
 /en-US/docs/CSS/:-moz-handler-crashed	/en-US/docs/Web/CSS/:-moz-handler-crashed
@@ -2084,7 +2084,6 @@
 /en-US/docs/DOM/window.URL.createObjectURL	/en-US/docs/Web/API/URL/createObjectURL_static
 /en-US/docs/DOM/window.URL.revokeObjectURL	/en-US/docs/Web/API/URL/revokeObjectURL_static
 /en-US/docs/DOM/window.alert	/en-US/docs/Web/API/Window/alert
-/en-US/docs/DOM/window.applicationCache	/en-US/docs/Web/API/Window/applicationCache
 /en-US/docs/DOM/window.atob	/en-US/docs/Web/API/atob
 /en-US/docs/DOM/window.back	/en-US/docs/Web/API/Window/back
 /en-US/docs/DOM/window.blur	/en-US/docs/Web/API/Window/blur
@@ -2549,7 +2548,6 @@
 /en-US/docs/DOM:treeWalker.whatToShow	/en-US/docs/Web/API/TreeWalker/whatToShow
 /en-US/docs/DOM:window	/en-US/docs/Web/API/Window
 /en-US/docs/DOM:window.alert	/en-US/docs/Web/API/Window/alert
-/en-US/docs/DOM:window.applicationCache	/en-US/docs/Web/API/Window/applicationCache
 /en-US/docs/DOM:window.atob	/en-US/docs/Web/API/atob
 /en-US/docs/DOM:window.back	/en-US/docs/Web/API/Window/back
 /en-US/docs/DOM:window.blur	/en-US/docs/Web/API/Window/blur
@@ -3268,7 +3266,6 @@
 /en-US/docs/Document_Object_Model_(DOM)/window.URL	/en-US/docs/Web/API/URL
 /en-US/docs/Document_Object_Model_(DOM)/window.URL.createObjectURL	/en-US/docs/Web/API/URL/createObjectURL_static
 /en-US/docs/Document_Object_Model_(DOM)/window.URL.revokeObjectURL	/en-US/docs/Web/API/URL/revokeObjectURL_static
-/en-US/docs/Document_Object_Model_(DOM)/window.applicationCache	/en-US/docs/Web/API/Window/applicationCache
 /en-US/docs/Document_Object_Model_(DOM)/window.captureEvents	/en-US/docs/Web/API/Window/captureEvents
 /en-US/docs/Document_Object_Model_(DOM)/window.clearImmediate	/en-US/docs/Web/API/Window/clearImmediate
 /en-US/docs/Document_Object_Model_(DOM)/window.clearInterval	/en-US/docs/Web/API/clearInterval
@@ -10243,7 +10240,7 @@
 /en-US/docs/Web/API/WorkerConsole.info()	/en-US/docs/Web/API/console/info
 /en-US/docs/Web/API/WorkerConsole.log	/en-US/docs/Web/API/console/log
 /en-US/docs/Web/API/WorkerGlobalScope.close	/en-US/docs/Web/API/DedicatedWorkerGlobalScope/close
-/en-US/docs/Web/API/WorkerGlobalScope.console	/en-US/docs/Web/API/WorkerGlobalScope/console
+/en-US/docs/Web/API/WorkerGlobalScope.console	/en-US/docs/Web/API/console
 /en-US/docs/Web/API/WorkerGlobalScope.dump	/en-US/docs/Web/API/WorkerGlobalScope/dump
 /en-US/docs/Web/API/WorkerGlobalScope.importScripts	/en-US/docs/Web/API/WorkerGlobalScope/importScripts
 /en-US/docs/Web/API/WorkerGlobalScope.location	/en-US/docs/Web/API/WorkerGlobalScope/location
@@ -10262,6 +10259,7 @@
 /en-US/docs/Web/API/WorkerGlobalScope/clearInterval	/en-US/docs/Web/API/clearInterval
 /en-US/docs/Web/API/WorkerGlobalScope/clearTimeout	/en-US/docs/Web/API/clearTimeout
 /en-US/docs/Web/API/WorkerGlobalScope/close	/en-US/docs/Web/API/DedicatedWorkerGlobalScope/close
+/en-US/docs/Web/API/WorkerGlobalScope/console	/en-US/docs/Web/API/console
 /en-US/docs/Web/API/WorkerGlobalScope/fetch	/en-US/docs/Web/API/fetch
 /en-US/docs/Web/API/WorkerGlobalScope/indexedDB	/en-US/docs/Web/API/indexedDB
 /en-US/docs/Web/API/WorkerGlobalScope/onclose	/en-US/docs/Web/API/DedicatedWorkerGlobalScope/close
@@ -10693,7 +10691,6 @@
 /en-US/docs/Web/API/window.URL.createObjectURL	/en-US/docs/Web/API/URL/createObjectURL_static
 /en-US/docs/Web/API/window.URL.revokeObjectURL	/en-US/docs/Web/API/URL/revokeObjectURL_static
 /en-US/docs/Web/API/window.alert	/en-US/docs/Web/API/Window/alert
-/en-US/docs/Web/API/window.applicationCache	/en-US/docs/Web/API/Window/applicationCache
 /en-US/docs/Web/API/window.atob	/en-US/docs/Web/API/atob
 /en-US/docs/Web/API/window.back	/en-US/docs/Web/API/Window/back
 /en-US/docs/Web/API/window.blur	/en-US/docs/Web/API/Window/blur
@@ -11253,6 +11250,7 @@
 /en-US/docs/Web/CSS/-webkit-user-select	/en-US/docs/Web/CSS/user-select
 /en-US/docs/Web/CSS/:-moz-any	/en-US/docs/Web/CSS/:is
 /en-US/docs/Web/CSS/:-moz-any-link	/en-US/docs/Web/CSS/:any-link
+/en-US/docs/Web/CSS/:-moz-focusring	/en-US/docs/Web/CSS/:focus-visible
 /en-US/docs/Web/CSS/:-moz-full-screen	/en-US/docs/Web/CSS/:fullscreen
 /en-US/docs/Web/CSS/:-moz-list-bullet	/en-US/docs/Web/CSS/::-moz-list-bullet
 /en-US/docs/Web/CSS/:-moz-list-number	/en-US/docs/Web/CSS/::-moz-list-number

diff --git a/files/en-us/_wikihistory.json b/files/en-us/_wikihistory.json
@@ -66684,25 +66684,6 @@
       "teoli"
     ]
   },
-  "Web/API/Window/applicationCache": {
-    "modified": "2020-12-08T02:25:04.101Z",
-    "contributors": [
-      "sideshowbarker",
-      "schalkneethling",
-      "placecarleen44",
-      "bershanskiy",
-      "alattalatta",
-      "chrisdavidmills",
-      "Sheppy",
-      "fscholz",
-      "teoli",
-      "ethertank",
-      "Jeremie",
-      "ebidel",
-      "Mgjbot",
-      "Kohei"
-    ]
-  },
   "Web/API/Window/back": {
     "modified": "2020-02-23T02:06:28.448Z",
     "contributors": [
@@ -69540,17 +69521,6 @@
       "teoli"
     ]
   },
-  "Web/API/WorkerGlobalScope/console": {
-    "modified": "2020-10-15T21:32:18.184Z",
-    "contributors": [
-      "sideshowbarker",
-      "fscholz",
-      "valentin.gosu",
-      "teoli",
-      "chrisdavidmills",
-      "kscarfone"
-    ]
-  },
   "Web/API/WorkerGlobalScope/dump": {
     "modified": "2020-10-15T21:32:18.913Z",
     "contributors": [
@@ -73733,23 +73703,6 @@
       "Mw22"
     ]
   },
-  "Web/CSS/:-moz-focusring": {
-    "modified": "2020-12-01T16:39:52.169Z",
-    "contributors": [
-      "mfluehr",
-      "cpmsmith",
-      "wbamberg",
-      "fscholz",
-      "chrisdavidmills",
-      "elharony",
-      "Enn2",
-      "Sebastianz",
-      "teoli",
-      "seth",
-      "Jonathan_Watt",
-      "Sheppy"
-    ]
-  },
   "Web/CSS/:-moz-handler-blocked": {
     "modified": "2020-08-06T11:19:00.766Z",
     "contributors": ["Sheppy", "wbamberg", "mfluehr", "teoli"]

diff --git a/...chniques/tilemaps/square_tilemaps_implementation_colon__scrolling_maps/index.md b/...chniques/tilemaps/square_tilemaps_implementation_colon__scrolling_maps/index.md
@@ -1,6 +1,7 @@
 ---
 title: "Square tilemaps implementation: Scrolling maps"
 slug: Games/Techniques/Tilemaps/Square_tilemaps_implementation:_Scrolling_maps
+page-type: guide
 ---
 
 {{GamesSidebar}}

diff --git a/.../techniques/tilemaps/square_tilemaps_implementation_colon__static_maps/index.md b/.../techniques/tilemaps/square_tilemaps_implementation_colon__static_maps/index.md
@@ -1,6 +1,7 @@
 ---
 title: "Square tilemaps implementation: Static maps"
 slug: Games/Techniques/Tilemaps/Square_tilemaps_implementation:_Static_maps
+page-type: guide
 ---
 
 {{GamesSidebar}}

diff --git a/files/en-us/glossary/adobe_flash/index.md b/files/en-us/glossary/adobe_flash/index.md
@@ -1,6 +1,7 @@
 ---
 title: Adobe Flash
 slug: Glossary/Adobe_Flash
+page-type: glossary-definition
 ---
 
 {{GlossarySidebar}}

diff --git a/files/en-us/glossary/baseline/compatibility/index.md b/files/en-us/glossary/baseline/compatibility/index.md
@@ -1,6 +1,7 @@
 ---
 title: Baseline (compatibility)
 slug: Glossary/Baseline/Compatibility
+page-type: glossary-definition
 ---
 
 {{GlossarySidebar}}

diff --git a/files/en-us/glossary/boolean/javascript/index.md b/files/en-us/glossary/boolean/javascript/index.md
@@ -1,12 +1,12 @@
 ---
-title: Boolean (Javascript)
+title: Boolean (JavaScript)
 slug: Glossary/Boolean/JavaScript
 page-type: glossary-definition
 ---
 
 {{GlossarySidebar}}
 
-A **Boolean** in Javascript is a {{Glossary("Primitive", "primitive value")}} that can be either `true` or `false`.
+A **Boolean** in JavaScript is a {{Glossary("Primitive", "primitive value")}} that can be either `true` or `false`.
 
 A {{jsxref("Boolean")}} object is a {{Glossary("wrapper")}} around a Boolean primitive.
 

diff --git a/files/en-us/glossary/percent-encoding/index.md b/files/en-us/glossary/percent-encoding/index.md
@@ -39,3 +39,4 @@ Depending on the context, the character `' '` is translated to a `'+'` (like in
 
 - Definition of [percent-encoding](https://en.wikipedia.org/wiki/Percent-encoding) in Wikipedia.
 - {{RFC(3986)}}, section 2.1, where this encoding is defined.
+- [`encodeURI()`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURI) and [`encodeURIComponent()`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) — functions to percent-encode URLs
diff --git a/files/en-us/glossary/plugin/index.md b/files/en-us/glossary/plugin/index.md
@@ -1,6 +1,7 @@
 ---
 title: Plugin
 slug: Glossary/Plugin
+page-type: glossary-definition
 ---
 
 {{GlossarySidebar}}

diff --git a/files/en-us/glossary/reflow/index.md b/files/en-us/glossary/reflow/index.md
@@ -6,8 +6,10 @@ page-type: glossary-definition
 
 {{GlossarySidebar}}
 
-**Reflow** happens when a {{glossary("browser")}} must process and draw part or all of a webpage again, such as after an update on an interactive site.
+**Reflow** happens when a {{glossary("browser")}} recalculates the position and geometry of certain parts of a webpage, such as after an update on an interactive site. This tends to be followed by repainting, which is when the browser redraws the webpage to show the resulting visual updates.
 
 ## See also
 
-- [Google article "Minimizing browser reflow"](https://developers.google.com/speed/docs/insights/browser-reflow)
+- [Repaint](/en-US/docs/Glossary/Repaint)
+- [Minimizing browser reflow](https://developer.google.com/speed/docs/insights/browser-reflow) on developer.google.com
+- [Understanding Reflow and Repaint in the browser](https://dev.to/gopal1996/understanding-reflow-and-repaint-in-the-browser-1jbg) on dev.to (2020)
diff --git a/files/en-us/glossary/render_blocking/index.md b/files/en-us/glossary/render_blocking/index.md
@@ -0,0 +1,17 @@
+---
+title: Render-blocking
+slug: Glossary/Render_blocking
+page-type: glossary-definition
+---
+
+{{GlossarySidebar}}
+
+**Render-blocking** refers to any part of the process of loading a website when it blocks the rendering of the user interface. Render-blocking is bad for web performance because it increases the length of time until users can interact with the site — for example viewing content or interacting with controls.
+
+The most common causes of render-blocking are initially-loaded CSS or JavaScript files.
+
+## See also
+
+- [CSS performance optimization](/en-US/docs/Learn/Performance/CSS)
+- [JavaScript performance optimization](/en-US/docs/Learn/Performance/JavaScript)
+- [What Are Render-Blocking Resources & How to Fix Render Blocking Issues](https://speckyboy.com/render-blocking/) on Speckyboy (2018)
diff --git a/files/en-us/glossary/repaint/index.md b/files/en-us/glossary/repaint/index.md
@@ -0,0 +1,14 @@
+---
+title: Repaint
+slug: Glossary/Repaint
+page-type: glossary-definition
+---
+
+{{GlossarySidebar}}
+
+**Repaint** happens when a {{glossary("browser")}} redraws a web page to show the visual updates resulting from a UI change, such as after an update on an interactive site. This usually follows reflowing, which is when the browser recalculates the position and geometry of certain parts of a web page.
+
+## See also
+
+- [Reflow](/en-US/docs/Glossary/Reflow)
+- [Understanding Reflow and Repaint in the browser](https://dev.to/gopal1996/understanding-reflow-and-repaint-in-the-browser-1jbg) on dev.to (2020)
diff --git a/files/en-us/glossary/replay_attack/index.md b/files/en-us/glossary/replay_attack/index.md
@@ -1,6 +1,7 @@
 ---
 title: Replay attack
 slug: Glossary/Replay_attack
+page-type: glossary-definition
 ---
 
 {{GlossarySidebar}}

diff --git a/files/en-us/glossary/rsync/index.md b/files/en-us/glossary/rsync/index.md
@@ -1,6 +1,7 @@
 ---
 title: Rsync
 slug: Glossary/Rsync
+page-type: glossary-definition
 ---
 
 {{GlossarySidebar}}

diff --git a/files/en-us/glossary/static_method/index.md b/files/en-us/glossary/static_method/index.md
@@ -14,7 +14,7 @@ Methods called on object instances are called _instance methods_.
 
 ## Examples
 
-In the [Notifications API](/en-US/docs/Web/API/Notifications_API), the {{domxref("Notification.requestPermission()")}} method is called on the actual {{domxref("Notification")}} constructor itself — it is a static method:
+In the [Notifications API](/en-US/docs/Web/API/Notifications_API), the {{domxref("Notification/requestPermission_static", "Notification.requestPermission()")}} method is called on the actual {{domxref("Notification")}} constructor itself — it is a static method:
 
 ```js
 let promise = Notification.requestPermission();

diff --git a/files/en-us/glossary/tcp_handshake/index.md b/files/en-us/glossary/tcp_handshake/index.md
@@ -6,7 +6,7 @@ page-type: glossary-definition
 
 {{GlossarySidebar}}
 
-{{glossary('Transmission Control Protocol (TCP)','TCP (Transmission Control Protocol)')}} uses a **three-way handshake** (aka TCP-handshake, three message handshake, and/or SYN-SYN-ACK) to set up a TCP/IP connection over an IP based network.
+{{glossary('TCP','TCP (Transmission Control Protocol)')}} uses a **three-way handshake** (aka TCP-handshake, three message handshake, and/or SYN-SYN-ACK) to set up a TCP/IP connection over an IP based network.
 
 The three messages transmitted by TCP to negotiate and start a TCP session are nicknamed SYN, _SYN-ACK_, and ACK for **SYN**chronize, **SYN**chronize-**ACK**nowledgement, and **ACK**nowledge respectively. The three message mechanism is designed so that two computers that want to pass information back and forth to each other can negotiate the parameters of the connection before transmitting data such as HTTP browser requests.
 

diff --git a/files/en-us/learn/css/building_blocks/selectors/index.md b/files/en-us/learn/css/building_blocks/selectors/index.md
@@ -175,6 +175,6 @@ article > p {
 
 In this article we've introduced CSS selectors, which enable you to target particular HTML elements. Next, we'll take a closer look at [type, class, and ID selectors](/en-US/docs/Learn/CSS/Building_blocks/Selectors/Type_Class_and_ID_Selectors).
 
-For a complete list of selectors, see our [CSS selectors reference](/en-US/docs/Web/CSS/CSS_Selectors).
+For a complete list of selectors, see our [CSS selectors reference](/en-US/docs/Web/CSS/CSS_selectors).
 
 {{NextMenu("Learn/CSS/Building_blocks/Selectors/Type_Class_and_ID_Selectors", "Learn/CSS/Building_blocks")}}