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 <[email protected]>
mdn · Jul 10, 2022 · c450c4c · c450c4c
1 parent 00d5f73
commit c450c4c
Show file tree

Hide file tree

Showing 40 changed files with 77 additions and 82 deletions.
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
 <div id="divA">This is <span>some</span> text!</div>
 ```
 
-... 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
@@ -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
 <canvas id="canvas"></canvas>
 ```
 
-... 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -82,7 +82,7 @@ An inline element that contains line breaks styled with:
 <span class="example">The<br>quick<br>orange fox</span>
 ```
 
-... 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
@@ -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
@@ -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