diff --git a/.github/workflows/markdown-lint.yml b/.github/workflows/markdown-lint.yml index 3f9704d355475fb..fee9351f939bf2f 100644 --- a/.github/workflows/markdown-lint.yml +++ b/.github/workflows/markdown-lint.yml @@ -7,6 +7,7 @@ on: paths: - .markdownlint-cli2.jsonc - .nvmrc + - .prettier* - package.json - yarn.lock - .github/workflows/markdown-lint.yml diff --git a/.github/workflows/pr-check_markdownlint.yml b/.github/workflows/pr-check_markdownlint.yml index ec21082e0b97b32..b1beaae2c76c048 100644 --- a/.github/workflows/pr-check_markdownlint.yml +++ b/.github/workflows/pr-check_markdownlint.yml @@ -45,3 +45,8 @@ jobs: yarn markdownlint-cli2 ${files_to_lint} echo "Linting front-matter" node scripts/front-matter_linter.js ${files_to_lint} + + - name: Prettier markdown files + run: | + files_to_lint="${{ env.DIFF_DOCUMENTS }}" + yarn prettier -c ${files_to_lint} diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt index fea82b3caab0ec9..711190614423dcb 100644 --- a/files/en-us/_redirects.txt +++ b/files/en-us/_redirects.txt @@ -3667,7 +3667,6 @@ /en-US/docs/HTML/Element/acronym-redirect-1 /en-US/docs/Web/HTML/Element/acronym /en-US/docs/HTML/Element/acronym2 /en-US/docs/Web/HTML/Element/acronym /en-US/docs/HTML/Element/address /en-US/docs/Web/HTML/Element/address -/en-US/docs/HTML/Element/applet /en-US/docs/Web/HTML/Element/applet /en-US/docs/HTML/Element/area /en-US/docs/Web/HTML/Element/area /en-US/docs/HTML/Element/area-redirect-1 /en-US/docs/Web/HTML/Element/area /en-US/docs/HTML/Element/article /en-US/docs/Web/HTML/Element/article @@ -3939,7 +3938,6 @@ /en-US/docs/HTML:Element:abbr /en-US/docs/Web/HTML/Element/abbr /en-US/docs/HTML:Element:acronym /en-US/docs/Web/HTML/Element/acronym /en-US/docs/HTML:Element:address /en-US/docs/Web/HTML/Element/address -/en-US/docs/HTML:Element:applet /en-US/docs/Web/HTML/Element/applet /en-US/docs/HTML:Element:area /en-US/docs/Web/HTML/Element/area /en-US/docs/HTML:Element:b /en-US/docs/Web/HTML/Element/b /en-US/docs/HTML:Element:base /en-US/docs/Web/HTML/Element/base diff --git a/files/en-us/_wikihistory.json b/files/en-us/_wikihistory.json index f23186d95301bfc..b48c52b12ee358e 100644 --- a/files/en-us/_wikihistory.json +++ b/files/en-us/_wikihistory.json @@ -94100,34 +94100,6 @@ "alecananian" ] }, - "Web/HTML/Element/applet": { - "modified": "2020-10-15T21:12:10.376Z", - "contributors": [ - "alattalatta", - "sideshowbarker", - "ddbeck", - "mfuji09", - "ExE-Boss", - "Sheppy", - "teoli", - "mfluehr", - "chrisdavidmills", - "erikadoyle", - "brunoais", - "kscarfone", - "ethertank", - "tregagnon", - "avsaro", - "cers", - "fscholz", - "osdm", - "Taken", - "Ptak82", - "Um4Sm1", - "Witia", - "PablO" - ] - }, "Web/HTML/Element/area": { "modified": "2020-11-09T11:29:48.831Z", "contributors": [ @@ -126782,10 +126754,6 @@ "Manuel_Strehl" ] }, - "Web/SVG/Element/discard": { - "modified": "2020-10-15T21:49:16.314Z", - "contributors": ["Tigt", "fscholz", "Sebastianz"] - }, "Web/SVG/Element/ellipse": { "modified": "2020-10-15T21:11:04.607Z", "contributors": [ diff --git a/files/en-us/learn/html/tables/basics/index.md b/files/en-us/learn/html/tables/basics/index.md index 9ca887bcb710e14..0be332fd1f24233 100644 --- a/files/en-us/learn/html/tables/basics/index.md +++ b/files/en-us/learn/html/tables/basics/index.md @@ -203,7 +203,7 @@ td { } ``` -{{EmbedLiveSample("How_does_a_table_work", 100, 460)}} +{{EmbedLiveSample("How_does_a_table_work", 100, 560)}} When implemented correctly, HTML tables are handled well by accessibility tools such as screen readers, so a successful HTML table should enhance the experience of sighted and visually impaired users alike. @@ -526,7 +526,7 @@ Now it's time to have a go yourself. Below you can see the timetable of a languages teacher. On Friday she has a new class teaching Dutch all day, but she also teaches German for a few periods on Tuesday and Thursdays. She wants to highlight the columns containing the days she is teaching. -{{EmbedGHLiveSample("learning-area/html/tables/basic/timetable-fixed.html", '100%', 320)}} +{{EmbedGHLiveSample("learning-area/html/tables/basic/timetable-fixed.html", '100%', 350)}} Recreate the table by following the steps below. diff --git a/files/en-us/learn/server-side/express_nodejs/mongoose/index.md b/files/en-us/learn/server-side/express_nodejs/mongoose/index.md index 0bbdf02cc7c4f6a..3351e45ae8ec640 100644 --- a/files/en-us/learn/server-side/express_nodejs/mongoose/index.md +++ b/files/en-us/learn/server-side/express_nodejs/mongoose/index.md @@ -142,7 +142,7 @@ try { ``` The asynchronous methods above are run in sequence. -If the methods don't depends on each other then you can run them in parallel and finish the whole operation more quickly. +If the methods don't depend on each other then you can run them in parallel and finish the whole operation more quickly. This done using the [`Promise.all()`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/all) method, which takes an iterable of promises as input and returns a single `Promise`. This returned promise fulfills when all of the input's promises fulfill, with an array of the fulfillment values. It rejects when any of the input's promises rejects, with this first rejection reason. diff --git a/files/en-us/learn/server-side/first_steps/web_frameworks/index.md b/files/en-us/learn/server-side/first_steps/web_frameworks/index.md index c99bee0e88347f6..f06ac77301f02d4 100644 --- a/files/en-us/learn/server-side/first_steps/web_frameworks/index.md +++ b/files/en-us/learn/server-side/first_steps/web_frameworks/index.md @@ -137,7 +137,7 @@ def youngest(request): ### Rendering data -Web frameworks often provide templating systems. These allow you to specify the structure of an output document, using placeholders for data that will be added when a page is generated. Templates are often used to create HTML, but can also create other types of document. +Web frameworks often provide templating systems. These allow you to specify the structure of an output document, using placeholders for data that will be added when a page is generated. Templates are often used to create HTML, but can also create other types of documents. Web frameworks often provide a mechanism to make it easy to generate other formats from stored data, including {{glossary("JSON")}} and {{glossary("XML")}}. diff --git a/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md b/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md index ae1d935a57b2c7d..3fbc32dd72c94ec 100644 --- a/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md +++ b/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md @@ -52,7 +52,7 @@ Make sure that the opening paragraph(s) before the first heading adequately summ In a guide or tutorial, the introductory paragraph(s) should inform the reader about the topics that will be covered as well as the prerequisite knowledge the reader is expected to have, if any. The opening paragraph should mention the technologies and/or APIs that are being documented or discussed, with links to the related information, and it should offer hints to situations in which the article's contents might be useful. -- **Example of short introduction** This example of an introduction is far too short. It leaves out too much information, such as what it means exactly to "stroke" text, where the text is drawn, and so forth. +- **Example of short introduction**: This example of an introduction is far too short. It leaves out too much information, such as what it means exactly to "stroke" text, where the text is drawn, and so forth. > **`CanvasRenderingContext2D.strokeText()`** draws a string. diff --git a/files/en-us/mozilla/firefox/releases/56/index.md b/files/en-us/mozilla/firefox/releases/56/index.md index d461bac414e9813..5efbd12de517a08 100644 --- a/files/en-us/mozilla/firefox/releases/56/index.md +++ b/files/en-us/mozilla/firefox/releases/56/index.md @@ -80,7 +80,7 @@ _No changes._ ### HTML - The {{htmlelement("isindex")}} element has been removed from the HTML parser, and from form submission ([Firefox bug 1266495](https://bugzil.la/1266495)). -- The {{htmlelement("applet")}} element has been removed ([Firefox bug 1279218](https://bugzil.la/1279218)). +- The `` element has been removed ([Firefox bug 1279218](https://bugzil.la/1279218)). ### APIs diff --git a/files/en-us/web/api/analysernode/fftsize/index.md b/files/en-us/web/api/analysernode/fftsize/index.md index f2fbd5b2ceaa7b7..8355d589a767c04 100644 --- a/files/en-us/web/api/analysernode/fftsize/index.md +++ b/files/en-us/web/api/analysernode/fftsize/index.md @@ -12,7 +12,7 @@ The **`fftSize`** property of the {{domxref("AnalyserNode")}} interface is an un ## Value -An unsigned integer, representing the window size of the FFT, given in number of samples. A higher value will result in more details in the frequency domain but fewer details in the time domain. +An unsigned integer, representing the window size of the FFT, given in number of samples. A higher value will result in more details in the frequency domain but fewer details in the amplitude domain. Must be a power of 2 between 2^5 and 2^15, so one of: `32`, `64`, `128`, `256`, `512`, `1024`, `2048`, `4096`, `8192`, `16384`, and `32768`. Defaults to `2048`. diff --git a/files/en-us/web/api/animation/commitstyles/index.md b/files/en-us/web/api/animation/commitstyles/index.md index 76b2c0369fcc29c..05ef98e74a36b77 100644 --- a/files/en-us/web/api/animation/commitstyles/index.md +++ b/files/en-us/web/api/animation/commitstyles/index.md @@ -10,7 +10,7 @@ browser-compat: api.Animation.commitStyles The `commitStyles()` method of the [Web Animations API](/en-US/docs/Web/API/Web_Animations_API)'s {{domxref("Animation")}} interface writes the [computed values](/en-US/docs/Web/CSS/computed_value) of the animation's current styles into its target element's [`style`](/en-US/docs/Web/HTML/Global_attributes#style) attribute. `commitStyles()` works even if the animation has been [automatically removed](/en-US/docs/Web/API/Web_Animations_API/Using_the_Web_Animations_API#automatically_removing_filling_animations). -`commitStyles()` can be used in combination with `fill` to cause the final state of an animation to persist after the animation ends. The same effect could be achieved with `fill` alone, but [using indefinitely filling animations is discouraged](https://w3c.github.io/csswg-drafts/web-animations-1/#fill-behavior). Animations [take precedence over all static styles](/en-US/docs/Web/CSS/Cascade#cascading_order), so an indefinite filling animation can prevent the target element from ever being styled normally. +`commitStyles()` can be used in combination with `fill` to cause the final state of an animation to persist after the animation ends. The same effect could be achieved with `fill` alone, but [using indefinitely filling animations is discouraged](https://drafts.csswg.org/web-animations-1/#fill-behavior). Animations [take precedence over all static styles](/en-US/docs/Web/CSS/Cascade#cascading_order), so an indefinite filling animation can prevent the target element from ever being styled normally. Using `commitStyles()` writes the styling state into the element's [`style`](/en-US/docs/Web/HTML/Global_attributes#style) attribute, where they can be modified and replaced as normal. diff --git a/files/en-us/web/api/clients/openwindow/index.md b/files/en-us/web/api/clients/openwindow/index.md index 2a08e39267c667a..65baf7e53958bf7 100644 --- a/files/en-us/web/api/clients/openwindow/index.md +++ b/files/en-us/web/api/clients/openwindow/index.md @@ -39,6 +39,15 @@ A {{jsxref("Promise")}} that resolves to a {{domxref("WindowClient")}} object if URL is from the same origin as the service worker or a {{Glossary("null", "null value")}} otherwise. +### Exceptions + +- `InvalidAccessError` {{domxref("DOMException")}} + - : The promise is rejected with this exception if none of the windows in the app's origin have [transient activation](/en-US/docs/Web/Security/User_activation). + +## Security requirements + +- At least one window in the app's origin must have [transient activation](/en-US/docs/Web/Security/User_activation). + ## Examples ```js diff --git a/files/en-us/web/api/css_custom_highlight_api/index.md b/files/en-us/web/api/css_custom_highlight_api/index.md index f87b206011ddc3b..85ce32868586772 100644 --- a/files/en-us/web/api/css_custom_highlight_api/index.md +++ b/files/en-us/web/api/css_custom_highlight_api/index.md @@ -8,7 +8,7 @@ browser-compat: - api.Highlight - api.HighlightRegistry - css.selectors.highlight -spec-urls: https://w3c.github.io/csswg-drafts/css-highlight-api-1/ +spec-urls: https://drafts.csswg.org/css-highlight-api-1/ --- {{DefaultAPISidebar("CSS Custom Highlight API")}}{{SeeCompatTable}} diff --git a/files/en-us/web/api/document/afterscriptexecute_event/index.md b/files/en-us/web/api/document/afterscriptexecute_event/index.md index 41b5df9834f5987..bee2df977f71737 100644 --- a/files/en-us/web/api/document/afterscriptexecute_event/index.md +++ b/files/en-us/web/api/document/afterscriptexecute_event/index.md @@ -38,7 +38,7 @@ document.addEventListener("afterscriptexecute", finished, true); document.onafterscriptexecute = finished; ``` -[View Live Example](https://media.prod.mdn.mozit.cloud/samples/html/currentScript.html) +[View Live Example](https://mdn.dev/archives/media/samples/html/currentScript.html) ## Browser compatibility diff --git a/files/en-us/web/api/document/beforescriptexecute_event/index.md b/files/en-us/web/api/document/beforescriptexecute_event/index.md index 30ffc29df502292..62ff3203ef1800e 100644 --- a/files/en-us/web/api/document/beforescriptexecute_event/index.md +++ b/files/en-us/web/api/document/beforescriptexecute_event/index.md @@ -38,7 +38,7 @@ document.addEventListener("beforescriptexecute", starting, true); document.onbeforescriptexecute = starting; ``` -[View Live Example](https://media.prod.mdn.mozit.cloud/samples/html/currentScript.html) +[View Live Example](https://mdn.dev/archives/media/samples/html/currentScript.html) ## Browser compatibility diff --git a/files/en-us/web/api/document/currentscript/index.md b/files/en-us/web/api/document/currentscript/index.md index a7887f50ece2910..f290d279f371260 100644 --- a/files/en-us/web/api/document/currentscript/index.md +++ b/files/en-us/web/api/document/currentscript/index.md @@ -30,7 +30,7 @@ if (document.currentScript.async) { } ``` -[View Live Examples](https://media.prod.mdn.mozit.cloud/samples/html/currentScript.html) +[View Live Examples](https://mdn.dev/archives/media/samples/html/currentScript.html) ## Specifications diff --git a/files/en-us/web/api/document/index.md b/files/en-us/web/api/document/index.md index f6f41acbadbcfb0..dd4fb330c921ba0 100644 --- a/files/en-us/web/api/document/index.md +++ b/files/en-us/web/api/document/index.md @@ -132,7 +132,7 @@ _The `Document` interface for HTML documents inherits from the {{DOMxRef("HTMLDo - {{DOMxRef("Document.anchors")}} {{Deprecated_Inline}} {{ReadOnlyInline}} - : Returns a list of all of the anchors in the document. - {{DOMxRef("Document.applets")}} {{Deprecated_Inline}} {{ReadOnlyInline}} - - : Returns an ordered list of the applets within a document. + - : Returns an empty {{domxref("HTMLCollection")}}. Legacy property that used to return the list of applets within a document. - {{DOMxRef("Document.bgColor")}} {{Deprecated_Inline}} - : Gets/sets the background color of the current document. - {{DOMxRef("Document.characterSet","Document.charset")}} {{Deprecated_Inline}} {{ReadOnlyInline}} diff --git a/files/en-us/web/api/document/mozsetimageelement/index.md b/files/en-us/web/api/document/mozsetimageelement/index.md index fd512d4c1af901b..0c64c1a432118b8 100644 --- a/files/en-us/web/api/document/mozsetimageelement/index.md +++ b/files/en-us/web/api/document/mozsetimageelement/index.md @@ -38,7 +38,7 @@ None ({{jsxref("undefined")}}). This example changes the background of a {{ HTMLElement("div") }} block each time the block is clicked by the user. -[View this example live](https://media.prod.mdn.mozit.cloud/samples/domref/mozSetImageElement.html). +[View this example live](https://mdn.dev/archives/media/samples/domref/mozSetImageElement.html). ```html