Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Correct usage of ellipsis, part 2 #18171

Merged
merged 23 commits into from
Jul 10, 2022
Merged
Show file tree
Hide file tree
Changes from 17 commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions files/en-us/web/api/console/debug/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/api/console/error/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/api/console/info/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/api/console/log/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.

Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/api/console/warn/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
6 changes: 3 additions & 3 deletions files/en-us/web/api/node/textcontent/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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!';
Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/api/textmetrics/width/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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');
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/web_audio_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
teoli2003 marked this conversation as resolved.
Show resolved Hide resolved
- [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))

Expand Down
3 changes: 2 additions & 1 deletion files/en-us/web/api/web_audio_api/simple_synth/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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;
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/webrtc_api/connectivity/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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, post card or a carrier pigeon. it's up to you.
teoli2003 marked this conversation as resolved.
Show resolved Hide resolved

The information we need to exchange is the Offer and Answer which just contains the {{Glossary("SDP")}} mentioned below.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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()

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/webxr_device_api/lighting/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/window/open/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/css/_colon_is/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 */
Expand All @@ -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 */
Expand Down
6 changes: 3 additions & 3 deletions files/en-us/web/css/border-bottom/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
7 changes: 3 additions & 4 deletions files/en-us/web/css/border-left/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
6 changes: 3 additions & 3 deletions files/en-us/web/css/border-right/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
6 changes: 3 additions & 3 deletions files/en-us/web/css/border-top/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/css/box-decoration-break/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand All @@ -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)

Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/css/font-size-adjust/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
6 changes: 3 additions & 3 deletions files/en-us/web/css/inherit/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading