From c450c4c454e1540327be87ae3fd8dd0becf52d68 Mon Sep 17 00:00:00 2001 From: Onkar Ruikar <87750369+OnkarRuikar@users.noreply.github.com> Date: Sun, 10 Jul 2022 13:56:25 +0530 Subject: [PATCH] Correct usage of ellipsis, part 2 (#18171) * Correct usage of ellipsis, part 2 * small fix * Remove ellipses altogether * Remove usage of ellipses. * Remove ellipsis * Remove ellispses at beginning of a line * Remove leading ellispses * Remove leading ellipses * Remove leading ellispses * Remove leading ellipses * Remove leading ellipses * Remove leading ellispses * Remove leading ellipses * Remove leading ellipses * Remove leading ellipsis * Remove leading ellipses * Remove leading ellipsis * Remove unnecessary ellipses * Update files/en-us/web/api/web_audio_api/index.md * Update files/en-us/web/api/webrtc_api/connectivity/index.md * Update files/en-us/web/javascript/reference/functions/rest_parameters/index.md * Update files/en-us/web/javascript/reference/operators/import/index.md * Update files/en-us/webassembly/exported_functions/index.md Co-authored-by: Jean-Yves Perrier --- files/en-us/web/api/console/debug/index.md | 4 ++-- files/en-us/web/api/console/error/index.md | 4 ++-- files/en-us/web/api/console/info/index.md | 4 ++-- files/en-us/web/api/console/log/index.md | 4 ++-- files/en-us/web/api/console/warn/index.md | 4 ++-- files/en-us/web/api/node/textcontent/index.md | 6 +++--- files/en-us/web/api/textmetrics/width/index.md | 4 ++-- files/en-us/web/api/web_audio_api/index.md | 2 +- .../web/api/web_audio_api/simple_synth/index.md | 3 ++- .../web/api/webrtc_api/connectivity/index.md | 2 +- .../api/webrtc_api/perfect_negotiation/index.md | 2 +- .../web/api/webxr_device_api/lighting/index.md | 2 +- files/en-us/web/api/window/open/index.md | 2 +- files/en-us/web/css/_colon_is/index.md | 4 ++-- files/en-us/web/css/border-bottom/index.md | 6 +++--- files/en-us/web/css/border-left/index.md | 7 +++---- files/en-us/web/css/border-right/index.md | 6 +++--- files/en-us/web/css/border-top/index.md | 6 +++--- .../en-us/web/css/box-decoration-break/index.md | 4 ++-- files/en-us/web/css/font-size-adjust/index.md | 4 ++-- files/en-us/web/css/inherit/index.md | 6 +++--- files/en-us/web/css/inheritance/index.md | 13 ++++--------- .../media_queries/using_media_queries/index.md | 6 +++--- files/en-us/web/css/reference/index.md | 2 +- .../en-us/web/css/shorthand_properties/index.md | 16 ++++++++-------- .../web/css/using_css_custom_properties/index.md | 4 ++-- .../guide/audio_and_video_manipulation/index.md | 2 +- .../en-us/web/html/element/input/month/index.md | 2 +- .../en-us/web/html/element/input/range/index.md | 2 +- .../a_re-introduction_to_javascript/index.md | 4 ++-- .../reference/functions/rest_parameters/index.md | 2 +- .../global_objects/function/apply/index.md | 2 +- .../reference/global_objects/math/max/index.md | 2 +- .../global_objects/symbol/asynciterator/index.md | 2 +- .../reference/operators/import/index.md | 2 +- files/en-us/web/mathml/index.md | 2 +- .../en-us/web/media/formats/containers/index.md | 4 ++-- files/en-us/web/svg/attribute/values/index.md | 2 +- .../web/svg/tutorial/fills_and_strokes/index.md | 2 +- .../webassembly/exported_functions/index.md | 2 +- 40 files changed, 77 insertions(+), 82 deletions(-) diff --git a/files/en-us/web/api/console/debug/index.md b/files/en-us/web/api/console/debug/index.md index bd0a2a63f273cd4..65dd8a1cb433084 100644 --- a/files/en-us/web/api/console/debug/index.md +++ b/files/en-us/web/api/console/debug/index.md @@ -36,13 +36,13 @@ debug(msg, subst1, /* ..., */ substN]) ### Parameters -- `obj1` ... `objN` +- `obj1` … `objN` - : A list of JavaScript objects to output. The string representations of each of these objects are appended together in the order listed and output to the console. - `msg` - : A JavaScript string containing zero or more substitution strings, which are replaced with `subst1` through `substN` in consecutive order. -- `subst1` ... `substN` +- `subst1` … `substN` - : JavaScript objects with which to replace substitution strings within `msg`. This gives you additional control over the format of the output. See {{SectionOnPage("/en-US/docs/Web/API/console", "Using string substitutions")}} for a diff --git a/files/en-us/web/api/console/error/index.md b/files/en-us/web/api/console/error/index.md index b324b5e0477c27d..e5671c83f68d86c 100644 --- a/files/en-us/web/api/console/error/index.md +++ b/files/en-us/web/api/console/error/index.md @@ -28,12 +28,12 @@ error(msg, subst1, /* ..., */ substN]) ### Parameters -- `obj1` ... `objN` +- `obj1` … `objN` - : A list of JavaScript objects to output. The string representations of each of these objects are appended together in the order listed and output. - `msg` - : A JavaScript string containing zero or more substitution strings. -- `subst1` ... `substN` +- `subst1` … `substN` - : JavaScript objects with which to replace substitution strings within `msg`. This gives you additional control over the format of the output. diff --git a/files/en-us/web/api/console/info/index.md b/files/en-us/web/api/console/info/index.md index 9a631c5b5751827..080492ae3b13025 100644 --- a/files/en-us/web/api/console/info/index.md +++ b/files/en-us/web/api/console/info/index.md @@ -29,12 +29,12 @@ info(msg, subst1, /* ..., */ substN]) ### Parameters -- `obj1` ... `objN` +- `obj1` … `objN` - : A list of JavaScript objects to output. The string representations of each of these objects are appended together in the order listed and output. - `msg` - : A JavaScript string containing zero or more substitution strings. -- `subst1` ... `substN` +- `subst1` … `substN` - : JavaScript objects with which to replace substitution strings within `msg`. This gives you additional control over the format of the output. diff --git a/files/en-us/web/api/console/log/index.md b/files/en-us/web/api/console/log/index.md index fd5e8d627c48644..ba0d719574d0e51 100644 --- a/files/en-us/web/api/console/log/index.md +++ b/files/en-us/web/api/console/log/index.md @@ -34,7 +34,7 @@ log(msg, subst1, /* ..., */ substN]) ### Parameters -- `obj1` ... `objN` +- `obj1` … `objN` - : A list of JavaScript objects to output. The string representations of each of these objects are appended together in the order listed and output. Please be warned that if you log objects in the latest versions of Chrome and Firefox what you get logged on @@ -43,7 +43,7 @@ log(msg, subst1, /* ..., */ substN]) it is the value of the object at the moment you open the console. - `msg` - : A JavaScript string containing zero or more substitution strings. -- `subst1` ... `substN` +- `subst1` … `substN` - : JavaScript objects with which to replace substitution strings within `msg`. This gives you additional control over the format of the output. diff --git a/files/en-us/web/api/console/warn/index.md b/files/en-us/web/api/console/warn/index.md index 59ec8fdbc1085dc..0b6eb235f610a62 100644 --- a/files/en-us/web/api/console/warn/index.md +++ b/files/en-us/web/api/console/warn/index.md @@ -32,12 +32,12 @@ warn(msg, subst1, /* ..., */ substN]) ### Parameters -- `obj1` ... `objN` +- `obj1` … `objN` - : A list of JavaScript objects to output. The string representations of each of these objects are appended together in the order listed and output. - `msg` - : A JavaScript string containing zero or more substitution strings. -- `subst1` ... `substN` +- `subst1` … `substN` - : JavaScript objects with which to replace substitution strings within `msg`. This gives you additional control over the format of the output. diff --git a/files/en-us/web/api/node/textcontent/index.md b/files/en-us/web/api/node/textcontent/index.md index f3667752881fefe..2c8e0db8f57c8e5 100644 --- a/files/en-us/web/api/node/textcontent/index.md +++ b/files/en-us/web/api/node/textcontent/index.md @@ -72,20 +72,20 @@ Moreover, using `textContent` can prevent {{glossary("Cross-site_scripting", "XS ## Examples -Given this HTML fragment: +Start with this HTML fragment. ```html
This is some text!
``` -... you can use `textContent` to get the element's text content: +You can use `textContent` to get the element's text content: ```js let text = document.getElementById('divA').textContent; // The text variable is now: 'This is some text!' ``` -... or set the element's text content: +If you prefer to set the element's text content, you can do: ```js document.getElementById('divA').textContent = 'This text is different!'; diff --git a/files/en-us/web/api/textmetrics/width/index.md b/files/en-us/web/api/textmetrics/width/index.md index 0638fd4d38c6fd2..3e1ae4c1e90a3c5 100644 --- a/files/en-us/web/api/textmetrics/width/index.md +++ b/files/en-us/web/api/textmetrics/width/index.md @@ -16,13 +16,13 @@ The read-only **`width`** property of the {{domxref("TextMetrics")}} interface c ## Examples -Given this {{HTMLElement("canvas")}} element: +Start with this {{HTMLElement("canvas")}} element: ```html ``` -... you can get a {{domxref("TextMetrics")}} object using the following code: +You can get a {{domxref("TextMetrics")}} object using the following code: ```js const canvas = document.getElementById('canvas'); diff --git a/files/en-us/web/api/web_audio_api/index.md b/files/en-us/web/api/web_audio_api/index.md index a1d91b9a8966579..f0cb27931eb27f5 100644 --- a/files/en-us/web/api/web_audio_api/index.md +++ b/files/en-us/web/api/web_audio_api/index.md @@ -230,7 +230,7 @@ You can find a number of examples at our [webaudio-example repo](https://github. - [Tone.js](https://tonejs.github.io/): a framework for creating interactive music in the browser. - [howler.js](https://github.com/goldfire/howler.js/): a JS audio library that defaults to [Web Audio API](https://webaudio.github.io/web-audio-api/) and falls back to [HTML5 Audio](https://html.spec.whatwg.org/multipage/media.html#the-audio-element), as well as providing other useful features. - [Mooog](https://github.com/mattlima/mooog): jQuery-style chaining of AudioNodes, mixer-style sends/returns, and more. -- [XSound](https://xsound.jp/): Web Audio API Library for Synthesizer, Effects, Visualization, Recording ... etc +- [XSound](https://xsound.jp/): Web Audio API Library for Synthesizer, Effects, Visualization, Recording, etc. - [OpenLang](https://github.com/chrisjohndigital/OpenLang): HTML5 video language lab web application using the Web Audio API to record and combine video and audio from different sources into a single file ([source on GitHub](https://github.com/chrisjohndigital/OpenLang)) - [Pts.js](https://ptsjs.org/): Simplifies web audio visualization ([guide](https://ptsjs.org/guide/sound-0800)) 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 index fa55b2c494bdacf..74a54986f8247b3 100644 --- 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 @@ -245,9 +245,10 @@ function createNoteTable() { noteFreq[1]["A"] = 55.000000000000000; noteFreq[1]["A#"] = 58.270470189761239; noteFreq[1]["B"] = 61.735412657015513; + // … ``` -... several octaves not shown for brevity ... +Several octaves not shown for brevity. ```js hidden noteFreq[2]["C"] = 65.406391325149658; diff --git a/files/en-us/web/api/webrtc_api/connectivity/index.md b/files/en-us/web/api/webrtc_api/connectivity/index.md index 5d0bdd40bfc897e..957bbf55eccb6ed 100644 --- a/files/en-us/web/api/webrtc_api/connectivity/index.md +++ b/files/en-us/web/api/webrtc_api/connectivity/index.md @@ -20,7 +20,7 @@ This article describes how the various WebRTC-related protocols interact with on ## Signaling -Unfortunately, WebRTC can't create connections without some sort of server in the middle. We call this the **signal channel** or **signaling service**. It's any sort of channel of communication to exchange information before setting up a connection, whether by email, post card or a carrier pigeon... it's up to you. +Unfortunately, WebRTC can't create connections without some sort of server in the middle. We call this the **signal channel** or **signaling service**. It's any sort of channel of communication to exchange information before setting up a connection, whether by email, postcard, or a carrier pigeon. It's up to you. The information we need to exchange is the Offer and Answer which just contains the {{Glossary("SDP")}} mentioned below. diff --git a/files/en-us/web/api/webrtc_api/perfect_negotiation/index.md b/files/en-us/web/api/webrtc_api/perfect_negotiation/index.md index be368bb6481ac51..7f26ab1ba15b0b3 100644 --- a/files/en-us/web/api/webrtc_api/perfect_negotiation/index.md +++ b/files/en-us/web/api/webrtc_api/perfect_negotiation/index.md @@ -209,7 +209,7 @@ On the other hand, if the received message contains an ICE candidate, we deliver ## Making negotiation perfect -If you're curious what makes perfect negotiation so... perfect... this section is for you. Here, we'll look at each change made to the WebRTC API and to best practice recommendations to make perfect negotiation possible. +If you're curious what makes perfect negotiation _so perfect_, this section is for you. Here, we'll look at each change made to the WebRTC API and to best practice recommendations to make perfect negotiation possible. ### Glare-free setLocalDescription() diff --git a/files/en-us/web/api/webxr_device_api/lighting/index.md b/files/en-us/web/api/webxr_device_api/lighting/index.md index b255e21bb535a98..1c060676e120b2f 100644 --- a/files/en-us/web/api/webxr_device_api/lighting/index.md +++ b/files/en-us/web/api/webxr_device_api/lighting/index.md @@ -145,7 +145,7 @@ Try to place light sources in realistic locations for the setting and the mood y ### Realism in player interactions with light -If your light source is located within the scene, you probably should try to ensure the viewer's avatar can't physically intersect with the light source. The results could be... strange. +If your light source is located within the scene, you probably should try to ensure the viewer's avatar can't physically intersect with the light source. The results could be strange. If the viewer's avatar is meant to have physical form, it should have a model, even if the viewer can never see it, so that light interacts with the avatar correctly. Minimally, this means the avatar should cast an appropriate shadow; however, depending on factors such as whether or not the avatar can be seen and the materials, texturing, and other attributes of the its model—including, especially, its reflectivity—the avatar may also need to reflect light, as well as potentially affect the coloration of the light reflected off of it. diff --git a/files/en-us/web/api/window/open/index.md b/files/en-us/web/api/window/open/index.md index 2b87374eff7062f..108a9c8719eb921 100644 --- a/files/en-us/web/api/window/open/index.md +++ b/files/en-us/web/api/window/open/index.md @@ -280,7 +280,7 @@ function openRequestedSinglePopup(url) { can also be disabled. Moving and resizing a window remotely on the user's screen via script will very often annoy the users, will disorient the user, and will be wrong at best. The web author expects to have full control of (and can decide about) every - position and size aspects of the users' browser window ... which is not true. + position and size aspects of the users' browser window, which is not true. - How do I know whether a window I opened is still open? - : You can test for the existence of the window object reference which is the returned diff --git a/files/en-us/web/css/_colon_is/index.md b/files/en-us/web/css/_colon_is/index.md index 5716232335d64fa..af73a18dd0825f7 100644 --- a/files/en-us/web/css/_colon_is/index.md +++ b/files/en-us/web/css/_colon_is/index.md @@ -139,7 +139,7 @@ function applyHandler(elem) { ### Simplifying list selectors -The `:is()` pseudo-class can greatly simplify your CSS selectors. For example, the following CSS: +The `:is()` pseudo-class can greatly simplify your CSS selectors. For example, take the following CSS: ```css /* 3-deep (or more) unordered lists use a square */ @@ -159,7 +159,7 @@ dir ol dir, dir ul dir, dir menu dir, dir dir dir { } ``` -... can be replaced with: +You can replace it with: ```css /* 3-deep (or more) unordered lists use a square */ diff --git a/files/en-us/web/css/border-bottom/index.md b/files/en-us/web/css/border-bottom/index.md index c6f365230437b70..317ba51dc6897c4 100644 --- a/files/en-us/web/css/border-bottom/index.md +++ b/files/en-us/web/css/border-bottom/index.md @@ -15,21 +15,21 @@ The **`border-bottom`** [shorthand](/en-US/docs/Web/CSS/Shorthand_properties) [C {{EmbedInteractiveExample("pages/css/border-bottom.html")}} -As with all shorthand properties, `border-bottom` always sets the values of all of the properties that it can set, even if they are not specified. It sets those that are not specified to their default values. This means that ... +As with all shorthand properties, `border-bottom` always sets the values of all of the properties that it can set, even if they are not specified. It sets those that are not specified to their default values. Consider the following code: ```css border-bottom-style: dotted; border-bottom: thick green; ``` -... is actually the same as ... +It is actually the same as this one: ```css border-bottom-style: dotted; border-bottom: none thick green; ``` -... and the value of {{cssxref("border-bottom-style")}} given before `border-bottom` is ignored. Since the default value of {{cssxref("border-bottom-style")}} is `none`, not specifying the `border-style` part results in no border. +The value of {{cssxref("border-bottom-style")}} given before `border-bottom` is ignored. Since the default value of {{cssxref("border-bottom-style")}} is `none`, not specifying the `border-style` part results in no border. ## Constituent properties diff --git a/files/en-us/web/css/border-left/index.md b/files/en-us/web/css/border-left/index.md index 292a45fc862530b..cc1173c1e6e45b0 100644 --- a/files/en-us/web/css/border-left/index.md +++ b/files/en-us/web/css/border-left/index.md @@ -15,21 +15,20 @@ The **`border-left`** [shorthand](/en-US/docs/Web/CSS/Shorthand_properties) [CSS {{EmbedInteractiveExample("pages/css/border-left.html")}} -As with all shorthand properties, `border-left` always sets the values of all of the properties that it can set, even if they are not specified. It sets those that are not specified to their default values. This means that ... - +As with all shorthand properties, `border-left` always sets the values of all of the properties that it can set, even if they are not specified. It sets those that are not specified to their default values. Consider the following code: ```css border-left-style: dotted; border-left: thick green; ``` -... is actually the same as ... +It is actually the same as this one: ```css border-left-style: dotted; border-left: none thick green; ``` -... and the value of {{cssxref("border-left-style")}} given before `border-left` is ignored. Since the default value of {{cssxref("border-left-style")}} is `none`, not specifying the `border-style` part results in no border. +The value of {{cssxref("border-left-style")}} given before `border-left` is ignored. Since the default value of {{cssxref("border-left-style")}} is `none`, not specifying the `border-style` part results in no border. ## Constituent properties diff --git a/files/en-us/web/css/border-right/index.md b/files/en-us/web/css/border-right/index.md index 33bb6a902d064de..ef08f0c413d387b 100644 --- a/files/en-us/web/css/border-right/index.md +++ b/files/en-us/web/css/border-right/index.md @@ -15,21 +15,21 @@ The **`border-right`** [shorthand](/en-US/docs/Web/CSS/Shorthand_properties) [CS {{EmbedInteractiveExample("pages/css/border-right.html")}} -As with all shorthand properties, `border-right` always sets the values of all of the properties that it can set, even if they are not specified. It sets those that are not specified to their default values. This means that ... +As with all shorthand properties, `border-right` always sets the values of all of the properties that it can set, even if they are not specified. It sets those that are not specified to their default values. Consider the following code: ```css border-right-style: dotted; border-right: thick green; ``` -... is actually the same as ... +It is actually the same as this one: ```css border-right-style: dotted; border-right: none thick green; ``` -... and the value of {{cssxref("border-right-style")}} given before `border-right` is ignored. Since the default value of {{cssxref("border-right-style")}} is `none`, not specifying the `border-style` part results in no border. +The value of {{cssxref("border-right-style")}} given before `border-right` is ignored. Since the default value of {{cssxref("border-right-style")}} is `none`, not specifying the `border-style` part results in no border. ## Constituent properties diff --git a/files/en-us/web/css/border-top/index.md b/files/en-us/web/css/border-top/index.md index f843c57fbb8af69..5739fab744998a6 100644 --- a/files/en-us/web/css/border-top/index.md +++ b/files/en-us/web/css/border-top/index.md @@ -15,21 +15,21 @@ The **`border-top`** [shorthand](/en-US/docs/Web/CSS/Shorthand_properties) [CSS] {{EmbedInteractiveExample("pages/css/border-top.html")}} -As with all shorthand properties, `border-top` always sets the values of all of the properties that it can set, even if they are not specified. It sets those that are not specified to their default values. This means that ... +As with all shorthand properties, `border-top` always sets the values of all of the properties that it can set, even if they are not specified. It sets those that are not specified to their default values. Consider the following code: ```css border-top-style: dotted; border-top: thick green; ``` -... is actually the same as ... +It is actually the same as this one: ```css border-top-style: dotted; border-top: none thick green; ``` -... and the value of {{cssxref("border-top-style")}} given before `border-top` is ignored. Since the default value of {{cssxref("border-top-style")}} is `none`, not specifying the `border-style` part results in no border. +The value of {{cssxref("border-top-style")}} given before `border-top` is ignored. Since the default value of {{cssxref("border-top-style")}} is `none`, not specifying the `border-style` part results in no border. ## Constituent properties diff --git a/files/en-us/web/css/box-decoration-break/index.md b/files/en-us/web/css/box-decoration-break/index.md index 2f56595cb31160f..072437115829383 100644 --- a/files/en-us/web/css/box-decoration-break/index.md +++ b/files/en-us/web/css/box-decoration-break/index.md @@ -82,7 +82,7 @@ An inline element that contains line breaks styled with: The
quick
orange fox
``` -... results in: +This results in: ![A screenshot of the rendering of an inline element styled with box-decoration-break:slice and styles given in the example.](box-decoration-break-inline-slice.png) @@ -93,7 +93,7 @@ Adding `box-decoration-break: clone` to the above styles: box-decoration-break: clone; ``` -... results in: +This one results in: ![A screenshot of the rendering of an inline element styled with box-decoration-break:clone and styles given in the example](box-decoration-break-inline-clone.png) diff --git a/files/en-us/web/css/font-size-adjust/index.md b/files/en-us/web/css/font-size-adjust/index.md index f8e86d801419aa9..33a44e5d77d9e85 100644 --- a/files/en-us/web/css/font-size-adjust/index.md +++ b/files/en-us/web/css/font-size-adjust/index.md @@ -32,14 +32,14 @@ font-size-adjust: unset; The property is useful since the legibility of fonts, especially at small sizes, is determined more by the size of lowercase letters than by the size of capital letters. Legibility can become an issue when the first-choice {{ Cssxref("font-family") }} is unavailable and its replacement has a significantly different aspect ratio (the ratio of the size of lowercase letters to the size of the font). -To use this property in a way that is compatible with browsers that do not support `font-size-adjust`, it is specified as a number that the {{ Cssxref("font-size") }} property is multiplied by. This means the value specified for the property should generally be the aspect ratio of the first choice font. For example, a style sheet that specifies: +To use this property in a way that is compatible with browsers that do not support `font-size-adjust`, it is specified as a number that the {{ Cssxref("font-size") }} property is multiplied by. This means the value specified for the property should generally be the aspect ratio of the first choice font. For example, consider this style sheet: ```css font-size: 14px; font-size-adjust: 0.5; ``` -... is really specifying that the lowercase letters of the font should be `7px` high (0.5 × 14px). This will still produce reasonable results in browsers that do not support `font-size-adjust`, where a `14px` font will be used. +It is really specifying that the lowercase letters of the font should be `7px` high (0.5 × 14px). This will still produce reasonable results in browsers that do not support `font-size-adjust`, where a `14px` font will be used. ## Syntax diff --git a/files/en-us/web/css/inherit/index.md b/files/en-us/web/css/inherit/index.md index a17290ba8e03946..f7809cc98b6aeea 100644 --- a/files/en-us/web/css/inherit/index.md +++ b/files/en-us/web/css/inherit/index.md @@ -30,17 +30,17 @@ For [inherited properties](/en-US/docs/Web/CSS/inheritance#inherited_properties) /* Make second-level headers green */ h2 { color: green; } -/* ...but leave those in the sidebar alone so they use their parent's color */ +/* Leave those in the sidebar alone so they use their parent's color */ #sidebar h2 { color: inherit; } ``` -In this example, the `h2` elements inside the sidebar might be different colors. For example, if one of them were the child of a `div` matched by the rule ... +In this example, the `h2` elements inside the sidebar might be different colors. For example, consider one of them that would by the child of a `div` matched by the rule: ```css div#current { color: blue; } ``` -... it would be blue. +Then, it would be blue. ## Specifications diff --git a/files/en-us/web/css/inheritance/index.md b/files/en-us/web/css/inheritance/index.md index 8c59abc6ae6fa87..e0295edf3498fe8 100644 --- a/files/en-us/web/css/inheritance/index.md +++ b/files/en-us/web/css/inheritance/index.md @@ -23,37 +23,32 @@ Refer to [any CSS property](/en-US/docs/Web/CSS/Reference#keyword_index) definit When no value for an **inherited property** has been specified on an element, the element gets the [computed value](/en-US/docs/Web/CSS/computed_value) of that property on its parent element. Only the root element of the document gets the [initial value](/en-US/docs/Web/CSS/initial_value) given in the property's summary. -A typical example of an inherited property is the {{ Cssxref("color") }} property. Given the style rules: +A typical example of an inherited property is the {{ Cssxref("color") }} property. Consider the following style rules and the markup: ```css p { color: green; } ``` -... and the markup: - ```html

This paragraph has emphasized text in it.

``` -... the words "emphasized text" will appear green, since the `em` element has inherited the value of the {{ Cssxref("color") }} property from the `p` element. It does _not_ get the initial value of the property (which is the color that is used for the root element when the page specifies no color). +The words "emphasized text" will appear green, since the `em` element has inherited the value of the {{ Cssxref("color") }} property from the `p` element. It does _not_ get the initial value of the property (which is the color that is used for the root element when the page specifies no color). ## Non-inherited properties When no value for a **non-inherited property** has been specified on an element, the element gets the [initial value](/en-US/docs/Web/CSS/initial_value) of that property (as specified in the property's summary). -A typical example of a non-inherited property is the {{ Cssxref("border") }} property. Given the style rules: - +A typical example of a non-inherited property is the {{ Cssxref("border") }} property. Consider the following style rules and the markup: ```css p { border: medium solid; } ``` -... and the markup: - ```html

This paragraph has emphasized text in it.

``` -... the words "emphasized text" will not have a border (since the initial value of {{ Cssxref("border-style") }} is `none`). +The words "emphasized text" will not have a border (since the initial value of {{ Cssxref("border-style") }} is `none`). ## Notes diff --git a/files/en-us/web/css/media_queries/using_media_queries/index.md b/files/en-us/web/css/media_queries/using_media_queries/index.md index aa6b17db98d2320..b476bb3b8ef1bc4 100644 --- a/files/en-us/web/css/media_queries/using_media_queries/index.md +++ b/files/en-us/web/css/media_queries/using_media_queries/index.md @@ -144,13 +144,13 @@ The `not` is evaluated last in the following query: @media not all and (monochrome) { ... } ``` -... so that the above query is evaluated like this: +This means that the above query is evaluated like this: ```css @media not (all and (monochrome)) { ... } ``` -... rather than like this: +It wouldn't be evaluated like this: ```css example-bad @media (not all) and (monochrome) { ... } @@ -162,7 +162,7 @@ As another example, the following media query: @media not screen and (color), print and (color) { ... } ``` -... is evaluated like this: +This means that the above query is evaluated like this: ```css @media (not (screen and (color))), print and (color) { ... } diff --git a/files/en-us/web/css/reference/index.md b/files/en-us/web/css/reference/index.md index e59c2a3ec644356..b1464dc74f0cabb 100644 --- a/files/en-us/web/css/reference/index.md +++ b/files/en-us/web/css/reference/index.md @@ -23,7 +23,7 @@ style-rule ::= } ``` -... where : +Where : ```css selectors-list ::= diff --git a/files/en-us/web/css/shorthand_properties/index.md b/files/en-us/web/css/shorthand_properties/index.md index 2fbe9790d7136fd..f6388f2f382ac8f 100644 --- a/files/en-us/web/css/shorthand_properties/index.md +++ b/files/en-us/web/css/shorthand_properties/index.md @@ -70,7 +70,7 @@ Similarly, shorthands handling properties related to corners of a box, like {{cs ## Background properties -A background with the following properties ... +Consider a background with the following properties ```css background-color: #000; @@ -79,7 +79,7 @@ background-repeat: no-repeat; background-position: left top; ``` -... can be shortened to just one declaration: +These four declarations can be shortened to just one: ```css background: #000 url(images/bg.gif) no-repeat left top; @@ -91,7 +91,7 @@ See {{cssxref("background")}} for more detailed information, including CSS3 prop ## Font properties -The following declarations ... +Consider the following declarations: ```css font-style: italic; @@ -101,7 +101,7 @@ line-height: 1.2; font-family: Arial, sans-serif; ``` -... can be shortened to the following: +This 5 statements can be shortened to the following: ```css font: italic bold .8em/1.2 Arial, sans-serif; @@ -111,7 +111,7 @@ This shorthand declaration is actually equivalent to the longhand declarations a ## Border properties -With borders, the width, color, and style can be simplified into one declaration. For example, the following CSS ... +With borders, the width, color, and style can be simplified into one declaration. For example, consider the following CSS: ```css border-width: 1px; @@ -119,7 +119,7 @@ border-style: solid; border-color: #000; ``` -... can be simplified as: +It can be simplified as: ```css border: 1px solid #000; @@ -127,7 +127,7 @@ border: 1px solid #000; ## Margin and padding properties -Shorthand versions of margin and padding values work similarly; the margin property allows for shorthand values to be specified using one, two, three, or four values. The following CSS declarations ... +Shorthand versions of margin and padding values work similarly; the margin property allows for shorthand values to be specified using one, two, three, or four values. Consider the following CSS declarations: ```css margin-top: 10px; @@ -136,7 +136,7 @@ margin-bottom: 10px; margin-left: 5px; ``` -... are the same as the following declaration using the four value shorthand. Note that the values are in clockwise order, beginning at the top: top, right, bottom, then left (TRBL, the consonants in "trouble"). +They are the same as the following declaration using the four value shorthand. Note that the values are in clockwise order, beginning at the top: top, right, bottom, then left (TRBL, the consonants in "trouble"). ```css margin: 10px 5px 10px 5px; diff --git a/files/en-us/web/css/using_css_custom_properties/index.md b/files/en-us/web/css/using_css_custom_properties/index.md index d94b4ec69cbd20f..3cc343dcea4f765 100644 --- a/files/en-us/web/css/using_css_custom_properties/index.md +++ b/files/en-us/web/css/using_css_custom_properties/index.md @@ -98,7 +98,7 @@ We'll apply it to this HTML: ``` -... which leads us to this: +This produces the following result: {{EmbedLiveSample("First_steps_with_custom_properties",600,180)}} @@ -170,7 +170,7 @@ Custom properties do inherit. This means that if no value is set for a custom pr ``` -... with the following CSS: +… with the following CSS: ```css .two { diff --git a/files/en-us/web/guide/audio_and_video_manipulation/index.md b/files/en-us/web/guide/audio_and_video_manipulation/index.md index b6f4934b62ba706..74a2540e397559c 100644 --- a/files/en-us/web/guide/audio_and_video_manipulation/index.md +++ b/files/en-us/web/guide/audio_and_video_manipulation/index.md @@ -190,7 +190,7 @@ window.addEventListener('load', setPlaybackRate); The Web Audio API can receive audio from a variety of sources, then process it and send it back out to an {{domxref("AudioDestinationNode")}} representing the output device to which the sound is sent after processing. -| If the audio source is... | Use this Web Audio node type | +| If the audio source is… | Use this Web Audio node type | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | | An audio track from an HTML {{HTMLElement("audio")}} or {{HTMLElement("video")}} element | {{domxref("MediaElementAudioSourceNode")}} | | A plain raw audio data buffer in memory | {{domxref("AudioBufferSourceNode")}} | diff --git a/files/en-us/web/html/element/input/month/index.md b/files/en-us/web/html/element/input/month/index.md index 68e0e8f43627960..ca3dfbe97484e4f 100644 --- a/files/en-us/web/html/element/input/month/index.md +++ b/files/en-us/web/html/element/input/month/index.md @@ -296,7 +296,7 @@ For example: - `mm-yyyy` (07-2022) - `yyyy-mm` (2022-07) - `Month yyyy` (July 2022) -- ... and so forth. +- and so forth… One way around this is to put a {{htmlattrxref("pattern", "input")}} attribute on your `month` input. Even though the `month` input doesn't use it, if the browser falls back to treating it like a `text` input, the pattern will be used. diff --git a/files/en-us/web/html/element/input/range/index.md b/files/en-us/web/html/element/input/range/index.md index 72216bdf9d776b7..dec9e668261095d 100644 --- a/files/en-us/web/html/element/input/range/index.md +++ b/files/en-us/web/html/element/input/range/index.md @@ -123,7 +123,7 @@ A string value of `any` means that no stepping is implied, and any value is allo > **Note:** When the data entered by the user doesn't adhere to the stepping configuration, the {{Glossary("user agent")}} may round to the nearest valid value, preferring numbers in the positive direction when there are two equally close options. -The default stepping value for `range` inputs is 1, allowing only integers to be entered, _unless_ the stepping base is not an integer; for example, if you set `min` to -10 and `value` to 1.5, then a `step` of 1 will allow only values such as 1.5, 2.5, 3.5,... in the positive direction and -0.5, -1.5, -2.5,... in the negative direction. See the [HTML `step` attribute](/en-US/docs/Web/HTML/Attributes/step). +The default stepping value for `range` inputs is 1, allowing only integers to be entered, _unless_ the stepping base is not an integer; for example, if you set `min` to -10 and `value` to 1.5, then a `step` of 1 will allow only values such as 1.5, 2.5, 3.5,… in the positive direction and -0.5, -1.5, -2.5,… in the negative direction. See the [HTML `step` attribute](/en-US/docs/Web/HTML/Attributes/step). ## Non Standard Attributes diff --git a/files/en-us/web/javascript/a_re-introduction_to_javascript/index.md b/files/en-us/web/javascript/a_re-introduction_to_javascript/index.md index 6ea0d6b6553ac63..9b90404a4d26651 100644 --- a/files/en-us/web/javascript/a_re-introduction_to_javascript/index.md +++ b/files/en-us/web/javascript/a_re-introduction_to_javascript/index.md @@ -35,7 +35,7 @@ Let's start off by looking at the building blocks of any language: the types. Ja - [Object](/en-US/docs/Web/JavaScript/Data_structures#objects) - [Symbol](/en-US/docs/Web/JavaScript/Data_structures#symbol_type) (new in ES2015) -... oh, and [undefined](/en-US/docs/Web/JavaScript/Data_structures#undefined_type) and [null](/en-US/docs/Web/JavaScript/Data_structures#null_type), which are ... slightly odd. And {{jsxref("Array")}}, which is a special kind of object. And {{jsxref("Date")}} and {{jsxref("RegExp")}}, which are objects that you get for free. And to be technically accurate, functions are just a special type of object. So the type diagram looks more like this: +In addition, there is also [undefined](/en-US/docs/Web/JavaScript/Data_structures#undefined_type) and [null](/en-US/docs/Web/JavaScript/Data_structures#null_type), which are slightly odd. And {{jsxref("Array")}}, which is a special kind of object. And {{jsxref("Date")}} and {{jsxref("RegExp")}}, which are objects that you get for free. And to be technically accurate, functions are just a special type of object. So the type diagram looks more like this: - [Number](/en-US/docs/Web/JavaScript/Data_structures#number_type) - [BigInt](/en-US/docs/Web/JavaScript/Data_structures#bigint_type) @@ -483,7 +483,7 @@ obj.name = 'Simon'; const name = obj.name; ``` -And... +And: ```js // bracket notation diff --git a/files/en-us/web/javascript/reference/functions/rest_parameters/index.md b/files/en-us/web/javascript/reference/functions/rest_parameters/index.md index 736807732f19b0a..e306a53150bd9a0 100644 --- a/files/en-us/web/javascript/reference/functions/rest_parameters/index.md +++ b/files/en-us/web/javascript/reference/functions/rest_parameters/index.md @@ -114,7 +114,7 @@ In this example, the first argument is mapped to `a` and the second to `b`, so these named arguments are used as normal. However, the third argument, `manyMoreArgs`, will be an array that contains -the third, fourth, fifth, sixth ... nth — as many arguments that the user includes. +the third, fourth, fifth, sixth, …, nth — as many arguments that the user includes. ```js function myFun(a, b, ...manyMoreArgs) { diff --git a/files/en-us/web/javascript/reference/global_objects/function/apply/index.md b/files/en-us/web/javascript/reference/global_objects/function/apply/index.md index 56d33f8f77ec555..28d88be93e32de4 100644 --- a/files/en-us/web/javascript/reference/global_objects/function/apply/index.md +++ b/files/en-us/web/javascript/reference/global_objects/function/apply/index.md @@ -65,7 +65,7 @@ But, if you pass an array to `push`, it will actually add that array as a single What if that is not what you want? `concat` does have the desired behavior in this case, but it does not append to the _existing_ array—it instead creates and returns a new array. -But you wanted to append to the existing array... So what now? Write a loop? Surely not? +But you wanted to append to the existing array. So what now? Write a loop? Surely not? `apply` to the rescue! diff --git a/files/en-us/web/javascript/reference/global_objects/math/max/index.md b/files/en-us/web/javascript/reference/global_objects/math/max/index.md index b10f296854be8f2..18ba139d28e63a1 100644 --- a/files/en-us/web/javascript/reference/global_objects/math/max/index.md +++ b/files/en-us/web/javascript/reference/global_objects/math/max/index.md @@ -30,7 +30,7 @@ Math.max(value0, value1, /* ... ,*/ valueN) ### Parameters -- `value1`, `value2`, ... , `valueN` +- `value1`, `value2`, … , `valueN` - : Zero or more numbers among which the largest value will be selected and returned. ### Return value diff --git a/files/en-us/web/javascript/reference/global_objects/symbol/asynciterator/index.md b/files/en-us/web/javascript/reference/global_objects/symbol/asynciterator/index.md index 77e129c4de4c052..d02ccfb1e5d23b1 100644 --- a/files/en-us/web/javascript/reference/global_objects/symbol/asynciterator/index.md +++ b/files/en-us/web/javascript/reference/global_objects/symbol/asynciterator/index.md @@ -63,4 +63,4 @@ There are currently no built-in JavaScript objects that have the `[Symbol.asyncI ## See also - [Iteration protocols](/en-US/docs/Web/JavaScript/Reference/Iteration_protocols) -- [for await... of](/en-US/docs/Web/JavaScript/Reference/Statements/for-await...of) +- [for await...of](/en-US/docs/Web/JavaScript/Reference/Statements/for-await...of) diff --git a/files/en-us/web/javascript/reference/operators/import/index.md b/files/en-us/web/javascript/reference/operators/import/index.md index 7f9b9c3b925dcf8..7426fa03b5a5bd8 100644 --- a/files/en-us/web/javascript/reference/operators/import/index.md +++ b/files/en-us/web/javascript/reference/operators/import/index.md @@ -121,7 +121,7 @@ if (typeof window === "undefined") { Dynamic imports allow any expression as the module specifier, not necessarily string literals. -Here, we load 10 modules: `/modules/module-0.js`, `/modules/module-1.js`... in parallel, and call the `load` functions that each one exports. +Here, we load 10 modules, `/modules/module-0.js`, `/modules/module-1.js`, etc., in parallel, and call the `load` functions that each one exports. ```js Promise.all( diff --git a/files/en-us/web/mathml/index.md b/files/en-us/web/mathml/index.md index 0ed6d59c91c8431..01159f195ca2f31 100644 --- a/files/en-us/web/mathml/index.md +++ b/files/en-us/web/mathml/index.md @@ -13,7 +13,7 @@ browser-compat: mathml.elements.math **Mathematical Markup Language (MathML)** is an [XML](/en-US/docs/Web/XML)-based language for describing mathematical notation. -[MathML](https://w3c.github.io/mathml/) was originally designed as a general-purpose specification for browsers, office suites, [computer algebra systems](https://en.wikipedia.org/wiki/Computer_algebra_system), [EPUB](https://www.w3.org/publishing/epub32/) readers, [LaTeX](https://en.wikipedia.org/wiki/LaTeX)-based generators... However, this approach was not very adapted to the Web: the [subset focusing on semantics](https://w3c.github.io/mathml/#contm) has never been implemented in browsers while the [subset focusing on math layout](https://w3c.github.io/mathml/#presm) led to incomplete and inconsistent browser implementations. +[MathML](https://w3c.github.io/mathml/) was originally designed as a general-purpose specification for browsers, office suites, [computer algebra systems](https://en.wikipedia.org/wiki/Computer_algebra_system), [EPUB](https://www.w3.org/publishing/epub32/) readers, [LaTeX](https://en.wikipedia.org/wiki/LaTeX)-based generators. However, this approach was not very adapted to the Web: the [subset focusing on semantics](https://w3c.github.io/mathml/#contm) has never been implemented in browsers while the [subset focusing on math layout](https://w3c.github.io/mathml/#presm) led to incomplete and inconsistent browser implementations. [MathML Core](https://w3c.github.io/mathml-core/) is a subset with increased implementation details based on rules from [LaTeX](https://en.wikipedia.org/wiki/LaTeX) and the [Open Font Format](https://docs.microsoft.com/en-us/typography/opentype/spec/math). It is tailored for browsers and designed specifically to work well with other web standards including [HTML](/en-US/docs/Web/HTML), [CSS](/en-US/docs/Web/CSS), [DOM](/en-US/docs/Web/API/Document_Object_Model), [JavaScript](/en-US/docs/Web/JavaScript). diff --git a/files/en-us/web/media/formats/containers/index.md b/files/en-us/web/media/formats/containers/index.md index c481bd8f4760974..c525a7f1c60fda1 100644 --- a/files/en-us/web/media/formats/containers/index.md +++ b/files/en-us/web/media/formats/containers/index.md @@ -1078,7 +1078,7 @@ Be sure to consider the needs of your application and your organization before s #### Audio-only files -| If you need... | Consider using this container format | +| If you need… | Consider using this container format | | --------------------------------------------- | ------------------------------------ | | Compressed files for general-purpose playback | MP3 (MPEG-1 Audio Layer III) | | Losslessly compressed files | FLAC with ALAC fallback | @@ -1089,7 +1089,7 @@ It's no longer necessary to choose between MP3's broad compatibility and the nee #### Video files -| If you need... | Consider using this container format | +| If you need… | Consider using this container format | | --------------------------------------------------- | --------------------------------------------------- | | General purpose video, preferably in an open format | WebM (ideally with MP4 fallback) | | General purpose video | MP4 (ideally with WebM or Ogg fallback) | diff --git a/files/en-us/web/svg/attribute/values/index.md b/files/en-us/web/svg/attribute/values/index.md index 16ce21bf1863d80..a02ce13aaf50ada 100644 --- a/files/en-us/web/svg/attribute/values/index.md +++ b/files/en-us/web/svg/attribute/values/index.md @@ -89,7 +89,7 @@ For the {{SVGElement("feColorMatrix")}} element, `values` is a list of numbers i - `` - : The value is a list of numbers, which is interpreted differently depending on the value of the `type` attribute: - - For `type="matrix"`, `values` is a list of 20 matrix values (a00 a01 a02 a03 a04 a10 a11 ... a34), separated by whitespace and/or a comma. + - For `type="matrix"`, `values` is a list of 20 matrix values (a00 a01 a02 a03 a04 a10 a11 … a34), separated by whitespace and/or a comma. - For `type="saturate"`, `values` is a single real number value (0 to 1). - For `type="hueRotate"`, `values` is a single one real number value (degrees). - For `type="luminanceToAlpha"`, `values` is not applicable. diff --git a/files/en-us/web/svg/tutorial/fills_and_strokes/index.md b/files/en-us/web/svg/tutorial/fills_and_strokes/index.md index 4cbecce07144b22..bfeea79430ab163 100644 --- a/files/en-us/web/svg/tutorial/fills_and_strokes/index.md +++ b/files/en-us/web/svg/tutorial/fills_and_strokes/index.md @@ -95,7 +95,7 @@ There are additional `stroke` and `fill` properties available, including `fill-r ## Using CSS -In addition to setting attributes on objects, you can also use CSS to style fills and strokes. Not all attributes can be set via CSS. Attributes that deal with painting and filling are usually available, so `fill`, `stroke`, `stroke-dasharray`, etc... can all be set this way, in addition to the gradient and pattern versions of those shown below. Attributes like `width`, `height`, or {{SVGElement("path")}} commands cannot be set through CSS. It's easiest just to test and find out what is available and what isn't. +In addition to setting attributes on objects, you can also use CSS to style fills and strokes. Not all attributes can be set via CSS. Attributes that deal with painting and filling are usually available, so `fill`, `stroke`, `stroke-dasharray`, etc. can all be set this way, in addition to the gradient and pattern versions of those shown below. Attributes like `width`, `height`, or {{SVGElement("path")}} commands cannot be set through CSS. It's easiest just to test and find out what is available and what isn't. > **Note:** The [SVG specification](https://www.w3.org/TR/SVG/propidx.html) decides strictly between attributes that are *properties* and other attributes. The former can be modified with CSS, the latter not. diff --git a/files/en-us/webassembly/exported_functions/index.md b/files/en-us/webassembly/exported_functions/index.md index d10eef00dac134d..97124b17c68db5f 100644 --- a/files/en-us/webassembly/exported_functions/index.md +++ b/files/en-us/webassembly/exported_functions/index.md @@ -14,7 +14,7 @@ tags: Exported WebAssembly functions are how WebAssembly functions are represented in JavaScript. This article describes what they are in a little more detail. -## Exported... what? +## Exported… What? Exported WebAssembly functions are basically just JavaScript wrappers that represent WebAssembly functions in JavaScript. When you call them, you get some activity in the background to convert the arguments into types that wasm can work with (for example converting JavaScript numbers to Int32), the arguments are passed to the function inside your wasm module, the function is invoked, and the result is converted and passed back to JavaScript.