diff --git a/.vscode/dictionaries/proper-names.txt b/.vscode/dictionaries/proper-names.txt index 14504fb3f3bbe94..485288e750d083b 100644 --- a/.vscode/dictionaries/proper-names.txt +++ b/.vscode/dictionaries/proper-names.txt @@ -628,6 +628,7 @@ Willee Willigers Winamp Winchelsea +Winnifred Wireshark Wirfs wisedog @@ -665,5 +666,6 @@ Zheng Zilla Zinsser Zosia +zxcvbn Émanuel Österreich diff --git a/.vscode/dictionaries/terms-abbreviations.txt b/.vscode/dictionaries/terms-abbreviations.txt index 74f7abb6dddba65..5e9bceb7129e6b7 100644 --- a/.vscode/dictionaries/terms-abbreviations.txt +++ b/.vscode/dictionaries/terms-abbreviations.txt @@ -366,6 +366,7 @@ lifecycles lightshow linecaps linkability +linkified linkify livemark livemarks @@ -675,6 +676,7 @@ spatializations spatialize spatialized SPDY +spearphishing speedwalk spinbuttons spinlocking diff --git a/files/en-us/games/anatomy/index.md b/files/en-us/games/anatomy/index.md index 8034151e5b7886c..c79733312f61b83 100644 --- a/files/en-us/games/anatomy/index.md +++ b/files/en-us/games/anatomy/index.md @@ -120,7 +120,7 @@ Modern versions of Firefox and Google Chrome (and probably others) _attempt_ to 1. Start a new frame (while the previous frame is handled by the display). 2. Go through the list of `requestAnimationFrame` callbacks and invoke them. 3. Perform garbage collection and other per-frame tasks when the above callbacks stop controlling the main thread. -4. Sleep (unless an event interrupts the browser's nap) until the monitor is ready for your image ([VSync](https://www.techopedia.com/definition/92/vertical-sync-vsync)) and repeat. +4. Sleep (unless an event interrupts the browser's nap) until the monitor is ready for your image ([VSync](https://en.wikipedia.org/wiki/Screen_tearing#Vertical_synchronization)) and repeat. You can think about developing realtime applications as having a budget of time to do work. All of the above steps must take place every 16-and-a-half milliseconds to keep up with a 60 Hz display. Browsers invoke your code as early as possible to give it maximum computation time. Your main thread will often start workloads that are not even on the main thread (such as rasterization or shaders in WebGL). Long calculations can be performed on a Web Worker or a GPU at the same time as the browser uses its main thread to manage garbage collection, its other tasks, or handle asynchronous events. diff --git a/files/en-us/glossary/static_method/index.md b/files/en-us/glossary/static_method/index.md index 2aff524cfc8c7f1..dc35734b592e295 100644 --- a/files/en-us/glossary/static_method/index.md +++ b/files/en-us/glossary/static_method/index.md @@ -29,7 +29,6 @@ myNotification.close(); ## See also -- [Static Method](https://www.techopedia.com/definition/24034/static-method-java) on Techopedia - [static](/en-US/docs/Web/JavaScript/Reference/Classes/static) - Related glossary terms: - {{Glossary("Object")}} diff --git a/files/en-us/learn_web_development/core/structuring_content/html_table_basics/index.md b/files/en-us/learn_web_development/core/structuring_content/html_table_basics/index.md index d2dbfb5f1ec62ec..be998236c9a4ec5 100644 --- a/files/en-us/learn_web_development/core/structuring_content/html_table_basics/index.md +++ b/files/en-us/learn_web_development/core/structuring_content/html_table_basics/index.md @@ -633,14 +633,14 @@ body { table { border-collapse: collapse; - border: 2px solid rgb(200, 200, 200); + border: 2px solid rgb(200 200 200); letter-spacing: 1px; font-size: 0.8rem; } td, th { - border: 1px solid rgb(190, 190, 190); + border: 1px solid rgb(190 190 190); padding: 10px 20px; } diff --git a/files/en-us/learn_web_development/core/structuring_content/planet_data_table/index.md b/files/en-us/learn_web_development/core/structuring_content/planet_data_table/index.md index 64df1eef607b198..864c8629b0a197d 100644 --- a/files/en-us/learn_web_development/core/structuring_content/planet_data_table/index.md +++ b/files/en-us/learn_web_development/core/structuring_content/planet_data_table/index.md @@ -16,7 +16,7 @@ In this challenge, we provide you with some data on the planets in our solar sys 2. Save the following HTML listing inside a file inside your folder called `index.html` (or paste it into your online editor's HTML pane). ```html - + diff --git a/files/en-us/learn_web_development/core/structuring_content/table_accessibility/index.md b/files/en-us/learn_web_development/core/structuring_content/table_accessibility/index.md index 6d716435fc5326f..8daa02bc8c9f0d0 100644 --- a/files/en-us/learn_web_development/core/structuring_content/table_accessibility/index.md +++ b/files/en-us/learn_web_development/core/structuring_content/table_accessibility/index.md @@ -136,7 +136,7 @@ A caption is placed directly beneath the `` tag. At this point we'll get you to try out adding a caption to an HTML table, using the school timetable you met in the previous article. -1. Copy the first HTML block in the [Grouping columns with `` and ``](/en-US/docs/Learn_web_development/Core/Structuring_content/HTML_table_basics#grouping_columns_with_colgroup_and_col) into an HTML file on your computer, or an online editor such as [CodePen](https://codepen.io/) or [JSBin](https://jsbin.com/?html,output). +1. Copy the first HTML block in the [Grouping columns with `` and ``](/en-US/docs/Learn_web_development/Core/Structuring_content/HTML_table_basics#grouping_columns_with_colgroup_and_col) into an HTML file on your computer, or an online editor such as [CodePen](https://codepen.io/) or [JSBin](https://jsbin.com/). 2. Add a suitable caption to the table. 3. Save your code and see what it looks like. diff --git a/files/en-us/learn_web_development/howto/web_mechanics/what_is_a_url/index.md b/files/en-us/learn_web_development/howto/web_mechanics/what_is_a_url/index.md index 26875789b0df5a1..17a6db8718041d7 100644 --- a/files/en-us/learn_web_development/howto/web_mechanics/what_is_a_url/index.md +++ b/files/en-us/learn_web_development/howto/web_mechanics/what_is_a_url/index.md @@ -133,7 +133,7 @@ All of the following URLs are relative URLs: - Scheme-relative URL: `//developer.mozilla.org/en-US/docs/Learn_web_development` — only the protocol is missing. The browser will use the same protocol as the one used to load the document hosting that URL. - Domain-relative URL: `/en-US/docs/Learn_web_development` — the protocol and the domain name are both missing. The browser will use the same protocol and the same domain name as the one used to load the document hosting that URL. - Sub-resources: `Howto/Web_mechanics/What_is_a_URL` — the protocol and domain name are missing, and the path doesn't begin with `/`. The browser will attempt to find the document in a subdirectory of the one containing the current resource. In this case, we really want to reach this URL: `https://developer.mozilla.org/en-US/docs/Learn_web_development/Howto/Web_mechanics/What_is_a_URL`. -- Going back in the directory tree: `../CSS/display` — the protocol and domain name are missing, and the path begins with `..`. This is inherited from the UNIX file system world — to tell the browser we want to go up by one level. Here we want to reach this URL: `https://developer.mozilla.org/en-US/docs/Learn_web_development/../Web/CSS/display`, which can be simplified to: `https://developer.mozilla.org/en-US/docs/Web/CSS/display`. +- Going back in the directory tree: `../CSS/Reference` — the protocol and domain name are missing, and the path begins with `..`. This is inherited from the UNIX file system world — to tell the browser we want to go up by one level. Here we want to reach this URL: `https://developer.mozilla.org/en-US/docs/Learn_web_development/../Web/CSS/Reference`, which can be simplified to: `https://developer.mozilla.org/en-US/docs/Web/CSS/Reference`. - Anchor-only: `#semantic_urls` - all parts are missing except the anchor. The browser will use the current document's URL and replace or add the anchor part to it. This is useful when you want to link to a specific part of the current document. ## URL usernames and passwords diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_function_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_function_page_template/index.md index 3637a0397525994..623ae4ff5165461 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_function_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_function_page_template/index.md @@ -17,14 +17,14 @@ sidebar: mdnsidebar > > ```md > --- -> title: NameOfTheFunction() -> slug: Web/CSS/NameOfTheFunction +> title: nameOfTheFunction() +> slug: Web/CSS/Reference/Values/nameOfTheFunction > page-type: css-function > status: > - deprecated > - experimental > - non-standard -> browser-compat: css.types.NameOfTheFunction +> browser-compat: css.types.nameOfTheFunction > sidebar: cssref > --- > ``` @@ -33,8 +33,8 @@ sidebar: mdnsidebar > - : The `title` value is displayed at the top of the page. The title format is _NameOfTheFunction()_. > For example, the [`pow()`](/en-US/docs/Web/CSS/Reference/Values/pow) function has a title of _pow()_. > - **slug** -> - : The `slug` value is the end of the URL path after `https://developer.mozilla.org/en-US/docs/`. This will be formatted as `Web/CSS/NameOfTheFunction`. Note the absence of parentheses in the slug. -> For example, the slug for the [`pow()`](/en-US/docs/Web/CSS/Reference/Values/pow) function is `Web/CSS/pow`. +> - : The `slug` value is the end of the URL path after `https://developer.mozilla.org/en-US/docs/`. This will be formatted as `Web/CSS/Reference/Values/nameOfTheFunction`. Note the absence of parentheses in the slug. +> For example, the slug for the [`pow()`](/en-US/docs/Web/CSS/Reference/Values/pow) function is `Web/CSS/Reference/Values/pow`. > - **page-type** > - : The `page-type` value for CSS functions is `css-function`. > - **status** diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_module_landing_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_module_landing_page_template/index.md index 93c247fc7b7c6c5..b7c468022bba79c 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_module_landing_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_module_landing_page_template/index.md @@ -18,7 +18,7 @@ sidebar: mdnsidebar > ```md > --- > title: CSS NameOfTheModule -> slug: Web/CSS/CSS_NameOfTheModule +> slug: Web/CSS/Guides/NameOfTheModule > page-type: css-module > spec-urls: > - url1 @@ -33,8 +33,8 @@ sidebar: mdnsidebar > For example, the title for the [grid layout](/en-US/docs/Web/CSS/Guides/Grid_layout) module landing page is _CSS grid layout_. > - **slug** > - : The `slug` value is the end of the URL path after `https://developer.mozilla.org/en-US/docs/`. -> This will be formatted as `Web/CSS/CSS_NameOfTheModule`. -> For example, the slug for the [grid layout](/en-US/docs/Web/CSS/Guides/Grid_layout) module landing page is `Web/CSS/CSS_grid_layout`. +> This will be formatted as `Web/CSS/Guides/NameOfTheModule`. +> For example, the slug for the [grid layout](/en-US/docs/Web/CSS/Guides/Grid_layout) module landing page is `Web/CSS/Guides/Grid_layout`. > - **page-type** > - : The `page-type` value for CSS module landing pages is always `css-module`. > - **spec-urls** diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_property_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_property_page_template/index.md index 61fb96454dfaf4c..b34b78c94c942e8 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_property_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_property_page_template/index.md @@ -17,24 +17,24 @@ sidebar: mdnsidebar > > ```md > --- -> title: NameOfTheProperty -> slug: Web/CSS/NameOfTheProperty +> title: name-of-the-property +> slug: Web/CSS/Reference/Properties/name-of-the-property > page-type: css-property OR css-shorthand-property > status: > - deprecated > - experimental > - non-standard -> browser-compat: css.properties.NameOfTheProperty +> browser-compat: css.properties.name-of-the-property > sidebar: cssref > --- > ``` > > - **title** -> - : The `title` value is displayed at the top of the page. The title format is _NameOfTheProperty_. +> - : The `title` value is displayed at the top of the page. The title format is _name-of-the-property_. > For example, the [`background-color`](/en-US/docs/Web/CSS/Reference/Properties/background-color) property has a title of _background-color_. > - **slug** -> - : The `slug` value is the end of the URL path after `https://developer.mozilla.org/en-US/docs/`. This will be formatted as `Web/CSS/NameOfTheProperty`. -> For example, the slug for the [`background-color`](/en-US/docs/Web/CSS/Reference/Properties/background-color) property is `Web/CSS/background-color`. For a multi-word component such as `Getting_started` in a slug, the slug should use an underscore as in `/en-US/docs/Learn_web_development/Core/Structuring_content`. +> - : The `slug` value is the end of the URL path after `https://developer.mozilla.org/en-US/docs/`. This will be formatted as `Web/CSS/Reference/Properties/name-of-the-property`. +> For example, the slug for the [`background-color`](/en-US/docs/Web/CSS/Reference/Properties/background-color) property is `Web/CSS/Reference/Properties/background-color`. For a multi-word component such as `Getting_started` in a slug, the slug should use an underscore as in `/en-US/docs/Learn_web_development/Core/Structuring_content`. > - **page-type** > - : The `page-type` value for CSS properties is `css-property`. For a shorthand CSS property, the value is `css-shorthand-property`. For example, the `page-type` value for the [animation](/en-US/docs/Web/CSS/Reference/Properties/animation) property is `css-shorthand-property` because it is a shorthand property, whereas the `page-type` value for the [animation-delay](/en-US/docs/Web/CSS/Reference/Properties/animation-delay) property is `css-property`. > - **status** diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_selector_page_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_selector_page_template/index.md index 0205022b22fab23..1da4680f7cff225 100644 --- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_selector_page_template/index.md +++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/css_selector_page_template/index.md @@ -17,14 +17,14 @@ sidebar: mdnsidebar > > ```md > --- -> title: :NameOfTheSelector -> slug: Web/CSS/:NameOfTheSelector +> title: :name-of-the-selector +> slug: Web/CSS/Reference/Selectors/:name-of-the-selector > page-type: css-selector OR css-pseudo-class OR css-pseudo-element OR css-combinator > status: > - deprecated > - experimental > - non-standard -> browser-compat: css.selectors.NameOfTheSelector +> browser-compat: css.selectors.name-of-the-selector > sidebar: cssref > --- > ``` @@ -33,8 +33,8 @@ sidebar: mdnsidebar > - : Title heading displayed at the top of the page. Format as _:NameOfTheSelector_. > For example, the [`:hover`](/en-US/docs/Web/CSS/Reference/Selectors/:hover) selector has a title of _:hover_. > - **slug** -> - : The end of the URL path after `https://developer.mozilla.org/en-US/docs/`). This will be formatted like `Web/CSS/:NameOfTheSelector`. -> For example, the [`:hover`](/en-US/docs/Web/CSS/Reference/Selectors/:hover) selector slug is `Web/CSS/:hover`. +> - : The end of the URL path after `https://developer.mozilla.org/en-US/docs/`). This will be formatted like `Web/CSS/Reference/Selectors/:name-of-the-selector`. +> For example, the [`:hover`](/en-US/docs/Web/CSS/Reference/Selectors/:hover) selector slug is `Web/CSS/Reference/Selectors/:hover`. > - **page-type** > - : The `page-type` key for CSS properties is one of `css-selector`, `css-pseudo-class`, or `css-pseudo-element`, depending on whether the selector is a [pseudo-class](/en-US/docs/Web/CSS/Reference/Selectors/Pseudo-classes), a [pseudo-element](/en-US/docs/Web/CSS/Reference/Selectors/Pseudo-elements), a [combinator](/en-US/docs/Web/CSS/Guides/Selectors/Selectors_and_combinators#combinators), or a [simple selector](/en-US/docs/Web/CSS/Guides/Selectors/Selector_structure#simple_selector). > - **status** diff --git a/files/en-us/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md b/files/en-us/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md index a5a20b41e2d2227..cb0490454f26c8c 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md @@ -24,7 +24,7 @@ let removing = browser.browsingData.removeFormData( ### Parameters - `removalOptions` - - : `object`. A {{WebExtAPIRef("browsingData.RemovalOptions")}} object, which may be used to clear only form data entered after a given time, and controi whether to clear form data entered in web pages or web pages and extensions. + - : `object`. A {{WebExtAPIRef("browsingData.RemovalOptions")}} object, which may be used to clear only form data entered after a given time, and controls whether to clear form data entered in web pages or web pages and extensions. ### Return value diff --git a/files/en-us/web/api/cache/delete/index.md b/files/en-us/web/api/cache/delete/index.md index bff4a9b1a4b35ba..e754d9de15bda19 100644 --- a/files/en-us/web/api/cache/delete/index.md +++ b/files/en-us/web/api/cache/delete/index.md @@ -46,7 +46,7 @@ delete(request, options) ### Return value -a {{jsxref("Promise")}} that resolves to `true` if the cache entry is +A {{jsxref("Promise")}} that resolves to `true` if the cache entry is deleted, or `false` otherwise. ## Examples diff --git a/files/en-us/web/api/cachestorage/delete/index.md b/files/en-us/web/api/cachestorage/delete/index.md index 67785046ce144a3..de26cc72017f750 100644 --- a/files/en-us/web/api/cachestorage/delete/index.md +++ b/files/en-us/web/api/cachestorage/delete/index.md @@ -26,7 +26,7 @@ delete(cacheName) ### Return value -a {{jsxref("Promise")}} that resolves to `true` if the {{domxref("Cache")}} +A {{jsxref("Promise")}} that resolves to `true` if the {{domxref("Cache")}} object is found and deleted, and `false` otherwise. ## Examples diff --git a/files/en-us/web/api/cachestorage/has/index.md b/files/en-us/web/api/cachestorage/has/index.md index 7a3b9dbbb4b472e..781a5567bee9689 100644 --- a/files/en-us/web/api/cachestorage/has/index.md +++ b/files/en-us/web/api/cachestorage/has/index.md @@ -27,7 +27,7 @@ has(cacheName) ### Return value -a {{jsxref("Promise")}} that resolves to `true` if the cache exists or +A {{jsxref("Promise")}} that resolves to `true` if the cache exists or `false` if not. ## Examples diff --git a/files/en-us/web/api/cachestorage/keys/index.md b/files/en-us/web/api/cachestorage/keys/index.md index bd2b81e381929eb..3c9c294530d163b 100644 --- a/files/en-us/web/api/cachestorage/keys/index.md +++ b/files/en-us/web/api/cachestorage/keys/index.md @@ -25,7 +25,7 @@ None. ### Return value -a {{jsxref("Promise")}} that resolves with an array of the {{domxref("Cache")}} names inside the {{domxref("CacheStorage")}} object. +A {{jsxref("Promise")}} that resolves with an array of the {{domxref("Cache")}} names inside the {{domxref("CacheStorage")}} object. ## Examples diff --git a/files/en-us/web/api/cachestorage/match/index.md b/files/en-us/web/api/cachestorage/match/index.md index 066ecb612083fb5..690ea6fdd7d6bcf 100644 --- a/files/en-us/web/api/cachestorage/match/index.md +++ b/files/en-us/web/api/cachestorage/match/index.md @@ -57,7 +57,7 @@ match(request, options) ### Return value -a {{jsxref("Promise")}} that resolves to the matching {{domxref("Response")}}. If +A {{jsxref("Promise")}} that resolves to the matching {{domxref("Response")}}. If no matching response to the specified request is found, the promise resolves with `undefined`. diff --git a/files/en-us/web/api/canvasrenderingcontext2d/createconicgradient/index.md b/files/en-us/web/api/canvasrenderingcontext2d/createconicgradient/index.md index d15663ab90b16ae..53ad93dcdab2772 100644 --- a/files/en-us/web/api/canvasrenderingcontext2d/createconicgradient/index.md +++ b/files/en-us/web/api/canvasrenderingcontext2d/createconicgradient/index.md @@ -32,8 +32,7 @@ createConicGradient(startAngle, x, y) ### Return value -- {{domxref("CanvasGradient")}} - - : A conic `CanvasGradient`. +A conic {{domxref("CanvasGradient")}}. ## Examples diff --git a/files/en-us/web/api/canvasrenderingcontext2d/createpattern/index.md b/files/en-us/web/api/canvasrenderingcontext2d/createpattern/index.md index 89b13a08eb1aafc..3171a4ff4a58c71 100644 --- a/files/en-us/web/api/canvasrenderingcontext2d/createpattern/index.md +++ b/files/en-us/web/api/canvasrenderingcontext2d/createpattern/index.md @@ -45,8 +45,7 @@ createPattern(image, repetition) ### Return value -- {{domxref("CanvasPattern")}} - - : An opaque object describing a pattern. +An opaque {{domxref("CanvasPattern")}} describing a pattern. If the `image` is not fully loaded ({{domxref("HTMLImageElement.complete")}} is `false`), then [`null`](/en-US/docs/Web/JavaScript/Reference/Operators/null) is returned. diff --git a/files/en-us/web/api/canvasrenderingcontext2d/ispointinpath/index.md b/files/en-us/web/api/canvasrenderingcontext2d/ispointinpath/index.md index 25f4246d058dbdc..aa128732506a31b 100644 --- a/files/en-us/web/api/canvasrenderingcontext2d/ispointinpath/index.md +++ b/files/en-us/web/api/canvasrenderingcontext2d/ispointinpath/index.md @@ -45,9 +45,7 @@ isPointInPath(path, x, y, fillRule) ### Return value -- A boolean value - - : A Boolean, which is `true` if the specified point is contained in the - current or specified path, otherwise `false`. +A boolean value, which is `true` if the specified point is contained in the current or specified path, otherwise `false`. ## Examples diff --git a/files/en-us/web/api/canvasrenderingcontext2d/ispointinstroke/index.md b/files/en-us/web/api/canvasrenderingcontext2d/ispointinstroke/index.md index be04faa99585283..bace7a2ffc217a4 100644 --- a/files/en-us/web/api/canvasrenderingcontext2d/ispointinstroke/index.md +++ b/files/en-us/web/api/canvasrenderingcontext2d/ispointinstroke/index.md @@ -32,9 +32,7 @@ isPointInStroke(path, x, y) ### Return value -- A boolean value - - : A Boolean, which is `true` if the point is inside the area contained by - the stroking of a path, otherwise `false`. +A boolean value, which is `true` if the point is inside the area contained by the stroking of a path, otherwise `false`. ## Examples diff --git a/files/en-us/web/api/datatransferitem/getasfile/index.md b/files/en-us/web/api/datatransferitem/getasfile/index.md index 86d9d3a6fe484a4..fb35c5e4d4a85c0 100644 --- a/files/en-us/web/api/datatransferitem/getasfile/index.md +++ b/files/en-us/web/api/datatransferitem/getasfile/index.md @@ -23,8 +23,7 @@ None. ### Return value -- {{domxref("File")}} - - : If the drag data item is a file, a {{domxref("File")}} object is returned; otherwise `null` is returned. +If the drag data item is a file, a {{domxref("File")}} object is returned; otherwise `null` is returned. ## Examples diff --git a/files/en-us/web/api/directoryentrysync/index.md b/files/en-us/web/api/directoryentrysync/index.md index 8a8dee52b846c64..a0fa2839c2f8513 100644 --- a/files/en-us/web/api/directoryentrysync/index.md +++ b/files/en-us/web/api/directoryentrysync/index.md @@ -59,8 +59,7 @@ None. ##### Return value -- [`DirectoryReaderSync`](/en-US/docs/Web/API/DirectoryReaderSync) - - : Represents a directory in a file system. +A [`DirectoryReaderSync`](/en-US/docs/Web/API/DirectoryReaderSync) object represents a directory in a file system. ##### Exceptions @@ -134,8 +133,7 @@ getFile(path, options) ##### Return value -- [`FileEntrySync`](/en-US/docs/Web/API/FileEntrySync) - - : Represents a file in a file system. +A [`FileEntrySync`](/en-US/docs/Web/API/FileEntrySync) object representing a file in a file system. ##### Exceptions @@ -216,8 +214,7 @@ getDirectory(path, options) ##### Return value -- [`DirectoryEntrySync`](/en-US/docs/Web/API/DirectoryReaderSync) - - : Represents a directory in a file system. +A [`DirectoryEntrySync`](/en-US/docs/Web/API/DirectoryReaderSync) object representing a directory in a file system. ##### Exceptions diff --git a/files/en-us/web/api/document/createtouch/index.md b/files/en-us/web/api/document/createtouch/index.md index b5c8fd070ae9287..ceb3cefdc568673 100644 --- a/files/en-us/web/api/document/createtouch/index.md +++ b/files/en-us/web/api/document/createtouch/index.md @@ -63,8 +63,7 @@ createTouch(view, target, identifier, pageX, pageY, screenX, screenY) ### Return value -- `touch` - - : A {{DOMxRef("Touch")}} object configured as described by the input parameters. +A {{DOMxRef("Touch")}} object configured as described by the input parameters. ## Examples diff --git a/files/en-us/web/api/document/createtouchlist/index.md b/files/en-us/web/api/document/createtouchlist/index.md index 2bab86f60c913e1..eeaa97cce20ae66 100644 --- a/files/en-us/web/api/document/createtouchlist/index.md +++ b/files/en-us/web/api/document/createtouchlist/index.md @@ -30,9 +30,7 @@ createTouchList(touch1, touch2, /* …, */ touchN) ### Return value -- `list` - - : A {{DOMxRef("TouchList")}} object containing the {{DOMxRef("Touch")}} objects - specified by the `touches` parameter. +A {{DOMxRef("TouchList")}} object containing the {{DOMxRef("Touch")}} objects specified by the `touches` parameter. ## Examples diff --git a/files/en-us/web/api/gpudevice/poperrorscope/index.md b/files/en-us/web/api/gpudevice/poperrorscope/index.md index f31892e2f6e50f1..72c6e908e48fdd6 100644 --- a/files/en-us/web/api/gpudevice/poperrorscope/index.md +++ b/files/en-us/web/api/gpudevice/poperrorscope/index.md @@ -23,7 +23,7 @@ None. ### Return value -a {{jsxref("Promise")}} that resolves to an object describing the first error captured in the scope. This can be of type: +A {{jsxref("Promise")}} that resolves to an object describing the first error captured in the scope. This can be of type: - {{domxref("GPUInternalError")}} - {{domxref("GPUOutOfMemoryError")}} diff --git a/files/en-us/web/api/htmlimageelement/ismap/index.md b/files/en-us/web/api/htmlimageelement/ismap/index.md index bd9fc0316b2df24..92e46938820c057 100644 --- a/files/en-us/web/api/htmlimageelement/ismap/index.md +++ b/files/en-us/web/api/htmlimageelement/ismap/index.md @@ -8,7 +8,7 @@ browser-compat: api.HTMLImageElement.isMap {{APIRef("HTML DOM")}} -The **`isMap`** property of the {{domxref("HTMLImageElement")}} interface indicates thatthe image is part of a [server-side map](https://en.wikipedia.org/wiki/Image_map#Server-side). If so, the coordinates where the user clicked on the image are sent to the server. It reflects the `` element's [`ismap`](/en-US/docs/Web/HTML/Reference/Elements/img#ismap) content attribute. This attribute is allowed only if the `` element is a descendant of an {{htmlelement("a")}} element with a valid [`href`](/en-US/docs/Web/HTML/Reference/Elements/a#href) attribute. +The **`isMap`** property of the {{domxref("HTMLImageElement")}} interface indicates that the image is part of a [server-side map](https://en.wikipedia.org/wiki/Image_map#Server-side). If so, the coordinates where the user clicked on the image are sent to the server. It reflects the `` element's [`ismap`](/en-US/docs/Web/HTML/Reference/Elements/img#ismap) content attribute. This attribute is allowed only if the `` element is a descendant of an {{htmlelement("a")}} element with a valid [`href`](/en-US/docs/Web/HTML/Reference/Elements/a#href) attribute. > [!NOTE] > For accessibility reasons, you should generally avoid using server-side image maps, as they require the use of a mouse. Use a [client-side image map](/en-US/docs/Web/HTML/How_to/Add_a_hit_map_on_top_of_an_image) instead. diff --git a/files/en-us/web/api/htmlimageelement/usemap/index.md b/files/en-us/web/api/htmlimageelement/usemap/index.md index 0991af05ee50833..6c11b11ca0d8bd7 100644 --- a/files/en-us/web/api/htmlimageelement/usemap/index.md +++ b/files/en-us/web/api/htmlimageelement/usemap/index.md @@ -35,7 +35,7 @@ Given the image map named `mainmenu-map`, you can dynamically construct images t ```js const image = new Image(); -image.src = "menubox.png"; +image.src = "menu-box.png"; image.alt = ""; image.useMap = "#mainmenu-map"; ``` diff --git a/files/en-us/web/api/navigator/sendbeacon/index.md b/files/en-us/web/api/navigator/sendbeacon/index.md index 9ff0dfd81f1f3df..e0faac5f51bb37a 100644 --- a/files/en-us/web/api/navigator/sendbeacon/index.md +++ b/files/en-us/web/api/navigator/sendbeacon/index.md @@ -35,9 +35,9 @@ sendBeacon(url, data) a string literal or object, a {{domxref("FormData")}} or a {{domxref("URLSearchParams")}} object containing the data to send. -### Return values +### Return value -The **`sendBeacon()`** method returns `true` if the +Returns `true` if the {{glossary("user agent")}} successfully queued the `data` for transfer. Otherwise, it returns `false`. diff --git a/files/en-us/web/api/remote_playback_api/index.md b/files/en-us/web/api/remote_playback_api/index.md index b4455898f6c5abd..8fb9170068e5ce4 100644 --- a/files/en-us/web/api/remote_playback_api/index.md +++ b/files/en-us/web/api/remote_playback_api/index.md @@ -14,7 +14,7 @@ The **Remote Playback API** extends the {{domxref("HTMLMediaElement")}} to enabl Remote playback devices are connected devices such as TVs, projectors, or speakers. The API takes into account wired devices connected via HDMI or DVI, and wireless devices, for example Chromecast or AirPlay. -The API enables a page, which has an media element such as a video or audio file, to initiate and control playback of that media on a connected remote device. For example, playing a video on a connected TV. +The API enables a page, which has a media element such as a video or audio file, to initiate and control playback of that media on a connected remote device. For example, playing a video on a connected TV. > [!NOTE] > Safari for iOS has some APIs which enable remote playback on AirPlay. Details of these can be found in [the Safari 9.0 release notes](https://developer.apple.com/library/archive/releasenotes/General/WhatsNewInSafari/Articles/Safari_9_0.html#//apple_ref/doc/uid/TP40014305-CH9-SW16). diff --git a/files/en-us/web/api/rtcremoteinboundrtpstreamstats/localid/index.md b/files/en-us/web/api/rtcremoteinboundrtpstreamstats/localid/index.md index 79234854e531656..b1d4c1a4129ac87 100644 --- a/files/en-us/web/api/rtcremoteinboundrtpstreamstats/localid/index.md +++ b/files/en-us/web/api/rtcremoteinboundrtpstreamstats/localid/index.md @@ -19,7 +19,7 @@ A string which can be compared to the value of an {{domxref("RTCOutboundRtpStrea ## Usage notes You can think of the local and remote views of the same RTP stream as pairs, each of which has a reference back to the other one. -Thus, if an {{domxref("RTCStatsReport")}} includes an `remote-inbound-rtp` statistics object (of type `RTCRemoteInboundRtpStreamStats`), it should also have a corresponding `outbound-rtp` object. +Thus, if an {{domxref("RTCStatsReport")}} includes a `remote-inbound-rtp` statistics object (of type `RTCRemoteInboundRtpStreamStats`), it should also have a corresponding `outbound-rtp` object. Both of these provide information about the same batch of packets being sent from the local device to the remote peer. The difference is that `outbound-rtp` offers statistics about the outgoing data from the local peer's perspective, while `remote-inbound-rtp` provides statistics about the same data from the perspective of the remote peer, as it is received. diff --git a/files/en-us/web/api/rtcremoteoutboundrtpstreamstats/localid/index.md b/files/en-us/web/api/rtcremoteoutboundrtpstreamstats/localid/index.md index 9ce82b05bb68a46..82e9fa7779eaf9b 100644 --- a/files/en-us/web/api/rtcremoteoutboundrtpstreamstats/localid/index.md +++ b/files/en-us/web/api/rtcremoteoutboundrtpstreamstats/localid/index.md @@ -19,7 +19,7 @@ A string which can be compared to the value of an {{domxref("RTCInboundRtpStream ## Usage notes You can think of the local and remote views of the same RTP stream as pairs, each of which has a reference back to the other one. -Thus, if an {{domxref("RTCStatsReport")}} includes an `remote-outbound-rtp` statistics object (of type `RTCRemoteOutboundRtpStreamStats`), it should also have a corresponding `inbound-rtp` object. +Thus, if an {{domxref("RTCStatsReport")}} includes a `remote-outbound-rtp` statistics object (of type `RTCRemoteOutboundRtpStreamStats`), it should also have a corresponding `inbound-rtp` object. Both of these provide information about the same batch of packets being transmitted from the remote peer to the local device. The difference is that `remote-outbound-rtp` describes statistics about data sent by the remote peer from the perspective of the remote peer, while `inbound-rtp` offers statistics about the incoming data from the local peer's perspective. diff --git a/files/en-us/web/api/touchlist/item/index.md b/files/en-us/web/api/touchlist/item/index.md index e2f76c796cae1cb..3bc46f79b4aeb09 100644 --- a/files/en-us/web/api/touchlist/item/index.md +++ b/files/en-us/web/api/touchlist/item/index.md @@ -25,9 +25,7 @@ item(index) ### Return value -- `touchPoint` - - : The requested {{ domxref("Touch") }} object from the {{ domxref("TouchList") }}. - Returns `null` if the index is not less than the length of the list. +The requested {{ domxref("Touch") }} object from the {{ domxref("TouchList") }}. Returns `null` if the index is not less than the length of the list. ## Examples diff --git a/files/en-us/web/api/trusted_types_api/index.md b/files/en-us/web/api/trusted_types_api/index.md index 2e30cad4584fced..7fef4c620dec8a5 100644 --- a/files/en-us/web/api/trusted_types_api/index.md +++ b/files/en-us/web/api/trusted_types_api/index.md @@ -136,7 +136,7 @@ element.innerHTML = userInput; ### Injection sink interfaces -This section provides an list of "direct" injection sink interfaces. +This section provides a list of "direct" injection sink interfaces. Note that there are cases where untrusted strings may be "indirectly injected", such as when an untrusted string is added as the child node of a script element, and then the element is added to the document. These cases are evaluated the untrusted script is added to the document. diff --git a/files/en-us/web/css/guides/animations/index.md b/files/en-us/web/css/guides/animations/index.md index dd1bcc79dd956ad..c8048521fcc4699 100644 --- a/files/en-us/web/css/guides/animations/index.md +++ b/files/en-us/web/css/guides/animations/index.md @@ -40,7 +40,7 @@ i { width: 16px; border-radius: 50%; animation: falling 3s linear 0s infinite backwards; - /* Snowflakes are made with CSS linear gradients (https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Images/Using_CSS_gradients) */ + /* Snowflakes are made with CSS linear gradients (https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Images/Using_gradients) */ background-image: linear-gradient(180deg, transparent 40%, white 40% 60%, transparent 60%), linear-gradient(90deg, transparent 40%, white 40% 60%, transparent 60%), @@ -48,7 +48,7 @@ i { linear-gradient(135deg, transparent 43%, white 43% 57%, transparent 57%); } i:nth-of-type(4n) { - /* Using tree structural pseudo-classes to create randomness - https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-of-type */ + /* Using tree structural pseudo-classes to create randomness - https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Selectors/:nth-of-type */ height: 30px; width: 30px; transform-origin: right -30px; diff --git a/files/en-us/web/css/how_to/layout_cookbook/index.md b/files/en-us/web/css/how_to/layout_cookbook/index.md index 91ac939008c883f..f9c5529073b5f4c 100644 --- a/files/en-us/web/css/how_to/layout_cookbook/index.md +++ b/files/en-us/web/css/how_to/layout_cookbook/index.md @@ -38,8 +38,8 @@ The CSS layout cookbook aims to bring together recipes for common layout pattern [grid-wrapper]: /en-US/docs/Web/CSS/How_to/Layout_cookbook/Grid_wrapper [css-grid]: /en-US/docs/Web/CSS/Guides/Grid_layout [multicol]: /en-US/docs/Web/CSS/Guides/Multicol_layout -[flexbox]: /en-US/docs/Web/CSS/CSS_flexible_box_layout -[box-alignment]: /en-US/docs/Web/CSS/CSS_box_alignment +[flexbox]: /en-US/docs/Web/CSS/Guides/Flexible_box_layout +[box-alignment]: /en-US/docs/Web/CSS/Guides/Box_alignment ## Contribute a Recipe diff --git a/files/en-us/web/css/reference/properties/list-style-type/index.md b/files/en-us/web/css/reference/properties/list-style-type/index.md index 15edbe5d16b67c1..6c7277743baf0a6 100644 --- a/files/en-us/web/css/reference/properties/list-style-type/index.md +++ b/files/en-us/web/css/reference/properties/list-style-type/index.md @@ -42,7 +42,7 @@ list-style-type: "\1F44D";

space-counter is defined with @counter-style diff --git a/files/en-us/web/css/reference/properties/transform-origin/index.md b/files/en-us/web/css/reference/properties/transform-origin/index.md index b4f3a1e691e3159..eaff1466ec8e5f6 100644 --- a/files/en-us/web/css/reference/properties/transform-origin/index.md +++ b/files/en-us/web/css/reference/properties/transform-origin/index.md @@ -112,7 +112,7 @@ function update() { const selected = document.querySelector(".selected"); /* Restart the animation - https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Animations/Tips */ + https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API/Tips */ el.className = ""; window.requestAnimationFrame(() => { window.requestAnimationFrame(() => { diff --git a/files/en-us/web/css/reference/selectors/pseudo-classes/index.md b/files/en-us/web/css/reference/selectors/pseudo-classes/index.md index 9fe191d14397cfa..10e371b3f3babc4 100644 --- a/files/en-us/web/css/reference/selectors/pseudo-classes/index.md +++ b/files/en-us/web/css/reference/selectors/pseudo-classes/index.md @@ -415,8 +415,8 @@ Non-standard vendor-prefixed pseudo-classes include: - {{CSSxRef(":-moz-handler-disabled")}} - {{CSSxRef(":-moz-last-node")}} - {{CSSxRef(":-moz-loading")}} -- {{CSSxRef(":-moz-locale-dir_ltr")}} -- {{CSSxRef(":-moz-locale-dir_rtl")}} +- {{CSSxRef(":-moz-locale-dir_ltr", ":-moz-locale-dir(ltr)")}} +- {{CSSxRef(":-moz-locale-dir_rtl", ":-moz-locale-dir(rtl)")}} - {{CSSxRef(":-moz-only-whitespace")}} - {{CSSxRef(":-moz-submit-invalid")}} - {{CSSxRef(":-moz-suppressed")}} diff --git a/files/en-us/web/css/reference/values/functions/index.md b/files/en-us/web/css/reference/values/functions/index.md index 3e79612cf1d272a..5decc6feae21f15 100644 --- a/files/en-us/web/css/reference/values/functions/index.md +++ b/files/en-us/web/css/reference/values/functions/index.md @@ -446,16 +446,16 @@ The following functions return an integer value based on the DOM tree, rather th - {{cssxref("color_value/rgb", "rgb()")}} - {{cssxref("transform-function/rotate", "rotate()")}} - {{cssxref("transform-function/rotate3d", "rotate3d()")}} -- {{cssxref("transform-function/rotatex", "rotatex()")}} -- {{cssxref("transform-function/rotatey", "rotatey()")}} -- {{cssxref("transform-function/rotatez", "rotatez()")}} +- {{cssxref("transform-function/rotateX", "rotateX()")}} +- {{cssxref("transform-function/rotateY", "rotateY()")}} +- {{cssxref("transform-function/rotateZ", "rotateZ()")}} - {{cssxref("round")}} - {{cssxref("filter-function/saturate", "saturate()")}} - {{cssxref("transform-function/scale", "scale()")}} - {{cssxref("transform-function/scale3d", "scale3d()")}} -- {{cssxref("transform-function/scalex", "scalex()")}} -- {{cssxref("transform-function/scaley", "scaley()")}} -- {{cssxref("transform-function/scalez", "scalez()")}} +- {{cssxref("transform-function/scaleX", "scaleX()")}} +- {{cssxref("transform-function/scaleY", "scaleY()")}} +- {{cssxref("transform-function/scaleZ", "scaleZ()")}} - {{cssxref("animation-timeline/scroll", "scroll()")}} - {{cssxref("filter-function/sepia", "sepia()")}} - {{cssxref("basic-shape/shape", "shape()")}} @@ -473,9 +473,9 @@ The following functions return an integer value based on the DOM tree, rather th - {{cssxref("tan")}} - {{cssxref("transform-function/translate", "translate()")}} - {{cssxref("transform-function/translate3d", "translate3d()")}} -- {{cssxref("transform-function/translatex", "translatex()")}} -- {{cssxref("transform-function/translatey", "translatey()")}} -- {{cssxref("transform-function/translatez", "translatez()")}} +- {{cssxref("transform-function/translateX", "translateX()")}} +- {{cssxref("transform-function/translateY", "translateY()")}} +- {{cssxref("transform-function/translateZ", "translateZ()")}} - {{cssxref("type")}} {{experimental_inline}} - {{cssxref("url_function")}} - {{cssxref("var")}} diff --git a/files/en-us/web/html/reference/elements/script/index.md b/files/en-us/web/html/reference/elements/script/index.md index 7c8348a6fdbbbbd..ebec3f20352f39b 100644 --- a/files/en-us/web/html/reference/elements/script/index.md +++ b/files/en-us/web/html/reference/elements/script/index.md @@ -344,5 +344,5 @@ so that the script doesn't block parsing but is guaranteed to be evaluated befor ## See also - {{domxref("document.currentScript")}} -- [Flavio Copes' article on loading JavaScript efficiently and explaining the differences between `async` and `defer`](https://flaviocopes.com/javascript-async-defer/) +- [Flavio Copes' article on loading JavaScript efficiently and explaining the differences between `async` and `defer`](https://thevalleyofcode.com/javascript-async-defer/) - [JavaScript modules](/en-US/docs/Web/JavaScript/Guide/Modules) guide diff --git a/files/en-us/web/privacy/guides/redirect_tracking_protection/index.md b/files/en-us/web/privacy/guides/redirect_tracking_protection/index.md index 43543ffa5c36a75..f7ff81e17bce35e 100644 --- a/files/en-us/web/privacy/guides/redirect_tracking_protection/index.md +++ b/files/en-us/web/privacy/guides/redirect_tracking_protection/index.md @@ -8,7 +8,7 @@ sidebar: privacy Since version 79, Firefox has protected users against **redirect tracking** by periodically clearing cookies and site data set by known trackers. This data is only cleared from storage if the user is [blocking tracking cookies](/en-US/docs/Web/Privacy/Guides/Storage_Access_Policy) (i.e., the `network.cookie.cookieBehavior` pref is set to `4`). > [!NOTE] -> This article refers to Firefox's original redirect/bounce tracking mechanism, which has since been superceded by [bounce tracking mitigations](/en-US/docs/Web/Privacy/Guides/Bounce_tracking_mitigations). +> This article refers to Firefox's original redirect/bounce tracking mechanism, which has since been superseded by [bounce tracking mitigations](/en-US/docs/Web/Privacy/Guides/Bounce_tracking_mitigations). Support for other cookie policies is tracked by [Bug 1643045](https://bugzil.la/1643045).