From 97783d1bf1725e56a656391f896e8bed77fb9ed5 Mon Sep 17 00:00:00 2001 From: Onkar Ruikar <87750369+OnkarRuikar@users.noreply.github.com> Date: Wed, 20 Jul 2022 11:54:56 +0530 Subject: [PATCH] Comment out ellipsis in code blocks (#18535) * Comment out ellipsis in code blocks * Apply suggestions from code review Co-authored-by: Jean-Yves Perrier * Update files/en-us/web/css/@media/-webkit-device-pixel-ratio/index.md Co-authored-by: Jean-Yves Perrier Co-authored-by: Jean-Yves Perrier --- .../primarylightdirection/index.md | 2 +- .../primarylightintensity/index.md | 2 +- .../sphericalharmonicscoefficients/index.md | 2 +- .../xrprojectionlayer/fixedfoveation/index.md | 2 +- files/en-us/web/api/xrreferencespace/index.md | 2 +- .../web/api/xrrigidtransform/inverse/index.md | 4 +- .../api/xrsystem/devicechange_event/index.md | 2 +- .../createcylinderlayer/index.md | 2 +- .../getdepthinformation/index.md | 4 +- .../xsltprocessor/generating_html/index.md | 10 ++--- .../-webkit-device-pixel-ratio/index.md | 12 +++--- files/en-us/web/css/_colon_is/index.md | 9 +++-- files/en-us/web/css/_colon_not/index.md | 2 +- files/en-us/web/css/_colon_where/index.md | 4 +- .../web/css/_doublecolon_placeholder/index.md | 6 +-- .../web/css/alternative_style_sheets/index.md | 6 +-- files/en-us/web/css/border-radius/index.md | 4 +- .../web/css/box-decoration-break/index.md | 33 +++++++-------- .../en-us/web/css/content-visibility/index.md | 18 ++++----- .../using_multiple_backgrounds/index.md | 2 +- .../index.md | 4 +- files/en-us/web/css/cursor/index.md | 6 +-- .../css/general_sibling_combinator/index.md | 2 +- files/en-us/web/css/line-height/index.md | 4 +- files/en-us/web/css/margin-trim/index.md | 2 +- .../testing_media_queries/index.md | 2 +- .../using_media_queries/index.md | 40 +++++++++---------- files/en-us/web/css/order/index.md | 4 +- files/en-us/web/css/ratio/index.md | 2 +- files/en-us/web/css/resolution/index.md | 2 +- files/en-us/web/css/text-transform/index.md | 16 ++++---- 31 files changed, 108 insertions(+), 104 deletions(-) diff --git a/files/en-us/web/api/xrlightestimate/primarylightdirection/index.md b/files/en-us/web/api/xrlightestimate/primarylightdirection/index.md index 8f6fa49f104dc6f..a01e990d4db4200 100644 --- a/files/en-us/web/api/xrlightestimate/primarylightdirection/index.md +++ b/files/en-us/web/api/xrlightestimate/primarylightdirection/index.md @@ -34,7 +34,7 @@ const lightProbe = await xrSession.requestLightProbe(); function onXRFrame(time, xrFrame) { let lightEstimate = xrFrame.getLightEstimate(lightProbe); - // Render lights ... + // Render lights // Available properties lightEstimate.primaryLightDirection; diff --git a/files/en-us/web/api/xrlightestimate/primarylightintensity/index.md b/files/en-us/web/api/xrlightestimate/primarylightintensity/index.md index 0693993942e37f1..f84f9d779561d37 100644 --- a/files/en-us/web/api/xrlightestimate/primarylightintensity/index.md +++ b/files/en-us/web/api/xrlightestimate/primarylightintensity/index.md @@ -34,7 +34,7 @@ const lightProbe = await xrSession.requestLightProbe(); function onXRFrame(time, xrFrame) { let lightEstimate = xrFrame.getLightEstimate(lightProbe); - // Render lights ... + // Render lights // Available properties lightEstimate.primaryLightDirection; diff --git a/files/en-us/web/api/xrlightestimate/sphericalharmonicscoefficients/index.md b/files/en-us/web/api/xrlightestimate/sphericalharmonicscoefficients/index.md index 5f7d89c8728ea7f..3404dc8be45e633 100644 --- a/files/en-us/web/api/xrlightestimate/sphericalharmonicscoefficients/index.md +++ b/files/en-us/web/api/xrlightestimate/sphericalharmonicscoefficients/index.md @@ -37,7 +37,7 @@ const lightProbe = await xrSession.requestLightProbe(); function onXRFrame(time, xrFrame) { let lightEstimate = xrFrame.getLightEstimate(lightProbe); - // Render lights using lightEstimate.sphericalHarmonicsCoefficients ... + // Render lights using lightEstimate.sphericalHarmonicsCoefficients } ``` diff --git a/files/en-us/web/api/xrprojectionlayer/fixedfoveation/index.md b/files/en-us/web/api/xrprojectionlayer/fixedfoveation/index.md index 584708ce52c0385..2da94f83d80a544 100644 --- a/files/en-us/web/api/xrprojectionlayer/fixedfoveation/index.md +++ b/files/en-us/web/api/xrprojectionlayer/fixedfoveation/index.md @@ -44,7 +44,7 @@ Some devices don't support foveated rendering. In that case `fixedFoveation` is The `fixedFoveation` property allows you to set the level of foveation at runtime and for each frame. To set the maximum foveation for a given {{domxref("XRProjectionLayer")}}, use a value of `1`. ```js -let glProjectionLayer = glBinding.createProjectionLayer(/* ... */); +let glProjectionLayer = glBinding.createProjectionLayer(/* … */); glProjectionLayer.fixedFoveation = 1; // maximum foveation ``` diff --git a/files/en-us/web/api/xrreferencespace/index.md b/files/en-us/web/api/xrreferencespace/index.md index 931aa17040e9e02..9cfb66052ad77fe 100644 --- a/files/en-us/web/api/xrreferencespace/index.md +++ b/files/en-us/web/api/xrreferencespace/index.md @@ -72,7 +72,7 @@ There are two situations in which you need to obtain an `XRReferenceSpace`. The ```js xrSession.requestReferenceSpace("local").then((refSpace) => { xrReferenceSpace = refSpace; - /* ... */ + // … }); ``` diff --git a/files/en-us/web/api/xrrigidtransform/inverse/index.md b/files/en-us/web/api/xrrigidtransform/inverse/index.md index 9893ed5a70efb7c..618ee1b9e28ae50 100644 --- a/files/en-us/web/api/xrrigidtransform/inverse/index.md +++ b/files/en-us/web/api/xrrigidtransform/inverse/index.md @@ -52,13 +52,13 @@ for (let view of pose.view) { let viewport = glLayer.getViewport(view); gl.viewport(viewport.x, viewport.y, viewport.width, viewport.height); - /* ... */ + // … mat4.multiply(modelViewMatrix, view.transform.inverse.matrix, objectMatrix); gl.uniformMatrix4fv(programInfo.uniformLocations.modelViewMatrix, false, modelViewMatrix); - /* ... */ + // … } ``` diff --git a/files/en-us/web/api/xrsystem/devicechange_event/index.md b/files/en-us/web/api/xrsystem/devicechange_event/index.md index ffc7569e45e20a1..c14dc18a8582de6 100644 --- a/files/en-us/web/api/xrsystem/devicechange_event/index.md +++ b/files/en-us/web/api/xrsystem/devicechange_event/index.md @@ -71,7 +71,7 @@ You can also use the `ondevicechange` event handler property to set a single han ```js if (navigator.xr) { navigator.xr.ondevicechange = event => { - /* ... etc ... */ + // … }; } ``` diff --git a/files/en-us/web/api/xrwebglbinding/createcylinderlayer/index.md b/files/en-us/web/api/xrwebglbinding/createcylinderlayer/index.md index 181746f8a4143fa..e9fafb130aaa551 100644 --- a/files/en-us/web/api/xrwebglbinding/createcylinderlayer/index.md +++ b/files/en-us/web/api/xrwebglbinding/createcylinderlayer/index.md @@ -115,7 +115,7 @@ function onXRSessionStarted(xrSession) { centralAngle : 60 * Math.PI / 180, aspectRatio : 2, radius : 2, - transform : new XRRigidTransform(/* ... */), + transform : new XRRigidTransform(/* … */), }); xrSession.updateRenderState({ diff --git a/files/en-us/web/api/xrwebglbinding/getdepthinformation/index.md b/files/en-us/web/api/xrwebglbinding/getdepthinformation/index.md index b271a76b9089c0b..f13fe0d65c25f29 100644 --- a/files/en-us/web/api/xrwebglbinding/getdepthinformation/index.md +++ b/files/en-us/web/api/xrwebglbinding/getdepthinformation/index.md @@ -59,7 +59,7 @@ const session = navigator.xr.requestSession("immersive-ar", { const glBinding = new XRWebGLBinding(session, gl); -// ... +// … // Obtain depth information in an active and animated frame function rafCallback(time, frame) { @@ -71,7 +71,7 @@ function rafCallback(time, frame) { if (depthInformation) { // Do something with the depth information // gl.bindTexture(gl.TEXTURE_2D, depthInformation.texture); - // ... + // … } } } diff --git a/files/en-us/web/api/xsltprocessor/generating_html/index.md b/files/en-us/web/api/xsltprocessor/generating_html/index.md index d3e554571ced978..3f7764767c3ea6a 100644 --- a/files/en-us/web/api/xsltprocessor/generating_html/index.md +++ b/files/en-us/web/api/xsltprocessor/generating_html/index.md @@ -37,7 +37,7 @@ The XSL Stylesheet used will need to have two namespaces - one for the XSLT elem xmlns:myNS="http://devedge.netscape.com/2002/de"> - ... + … ``` @@ -46,7 +46,7 @@ A template matching the root node of the XML document is created and used to cre **Figure 4: Creating the basic HTML document** ```xml -... +… @@ -80,7 +80,7 @@ A template matching the root node of the XML document is created and used to cre -... +… ``` Three more `xsl:template`'s are needed to complete the example. The first `xsl:template` is used for the author nodes, while the second one processes the body node. The third template has a general matching rule which will match any node and any attribute. It is needed in order to preserve the HTML elements in the XML document, since it matches all of them and copies them out into the HTML document the transformation creates. @@ -88,7 +88,7 @@ Three more `xsl:template`'s are needed to complete the example. The first `xsl:t **Figure 5: Final 3 Templates** ```xml -... +… -- @@ -112,7 +112,7 @@ Three more `xsl:template`'s are needed to complete the example. The first `xsl:t -... +… ``` The final XSLT stylesheet looks as follows: diff --git a/files/en-us/web/css/@media/-webkit-device-pixel-ratio/index.md b/files/en-us/web/css/@media/-webkit-device-pixel-ratio/index.md index 5799895158441dc..d14257bcfcfa2b9 100644 --- a/files/en-us/web/css/@media/-webkit-device-pixel-ratio/index.md +++ b/files/en-us/web/css/@media/-webkit-device-pixel-ratio/index.md @@ -29,14 +29,14 @@ The `-webkit-device-pixel-ratio` feature is specified as a {{cssxref("<number ```css /* A unit of "dppx" is implied: */ -@media (-webkit-min-device-pixel-ratio: 2) { ... } -/* ... is equivalent to: */ -@media (min-resolution: 2dppx) { ... } +@media (-webkit-min-device-pixel-ratio: 2) { /* … */ } +/* It is equivalent to: */ +@media (min-resolution: 2dppx) { /* … */ } /* Similarly: */ -@media (-webkit-max-device-pixel-ratio: 2) { ... } -/* ... is equivalent to: */ -@media (max-resolution: 2dppx) { ... } +@media (-webkit-max-device-pixel-ratio: 2) { /* … */ } +/* It is equivalent to: */ +@media (max-resolution: 2dppx) { /* … */ } ``` ## Examples diff --git a/files/en-us/web/css/_colon_is/index.md b/files/en-us/web/css/_colon_is/index.md index af73a18dd0825f7..ced40c456c431e8 100644 --- a/files/en-us/web/css/_colon_is/index.md +++ b/files/en-us/web/css/_colon_is/index.md @@ -48,7 +48,7 @@ In CSS when using a selector list, if any of the selectors are invalid then the ```css :is(:valid, :unsupported) { - ... + /* … */ } ``` @@ -56,7 +56,7 @@ Will still parse correctly and match `:valid` even in browsers which don't suppo ```css :valid, :unsupported { - ... + /* … */ } ``` @@ -179,10 +179,12 @@ For example, without `:is()`, styling all the {{HTMLElement("h1")}} elements at h1 { font-size: 30px; } + /* Level 1 */ section h1, article h1, aside h1, nav h1 { font-size: 25px; } + /* Level 2 */ section section h1, section article h1, section aside h1, section nav h1, article section h1, article article h1, article aside h1, article nav h1, @@ -190,8 +192,9 @@ aside section h1, aside article h1, aside aside h1, aside nav h1, nav section h1, nav article h1, nav aside h1, nav nav h1 { font-size: 20px; } + /* Level 3 */ -/* ... don't even think about it! */ +/* don't even think about it! */ ``` Using `:is()`, though, it's much easier: diff --git a/files/en-us/web/css/_colon_not/index.md b/files/en-us/web/css/_colon_not/index.md index 33e1161ce92fbc8..9b5bf8b7d2d7cef 100644 --- a/files/en-us/web/css/_colon_not/index.md +++ b/files/en-us/web/css/_colon_not/index.md @@ -37,7 +37,7 @@ The `:not()` pseudo-class requires a comma-separated list of one or more selecto There are several unusual effects and outcomes when using `:not()` that you should keep in mind when using it: -- The `:not` pseudo-class may not be nested, which means that `:not(:not(...))` is invalid. +- The `:not` pseudo-class may not be nested, which means that `:not(:not( ))` is invalid. - Useless selectors can be written using this pseudo-class. For example, `:not(*)` matches any element which is not an element, which is obviously nonsense, so the accompanying rule will never be applied. - This pseudo-class can increase the [specificity](/en-US/docs/Web/CSS/Specificity) of a rule. For example, `#foo:not(#bar)` will match the same element as the simpler `#foo`, but has the higher specificity of two `id` selectors. - The specificity of the `:not()` pseudo-class is replaced by the specificity of the most specific selector in its comma-separated argument of selectors; providing the same specificity as if it had been written [`:not(:is(argument))`](/en-US/docs/Web/CSS/:is). diff --git a/files/en-us/web/css/_colon_where/index.md b/files/en-us/web/css/_colon_where/index.md index 2a86398d3cbe87a..1f42f0b46f21cc8 100644 --- a/files/en-us/web/css/_colon_where/index.md +++ b/files/en-us/web/css/_colon_where/index.md @@ -45,7 +45,7 @@ In CSS when using a selector list, if any of the selectors are invalid then the ```css :where(:valid, :unsupported) { - ... + /* … */ } ``` @@ -53,7 +53,7 @@ Will still parse correctly and match `:valid` even in browsers which don't suppo ```css :valid, :unsupported { - ... + /* … */ } ``` diff --git a/files/en-us/web/css/_doublecolon_placeholder/index.md b/files/en-us/web/css/_doublecolon_placeholder/index.md index 516d09a10ed9aa3..5426281b421b6e7 100644 --- a/files/en-us/web/css/_doublecolon_placeholder/index.md +++ b/files/en-us/web/css/_doublecolon_placeholder/index.md @@ -79,7 +79,7 @@ This example shows some of the adjustments that you can make to the styles of pl #### HTML ```html - + ``` #### CSS @@ -103,8 +103,8 @@ Some browsers (such as Firefox) set the default {{cssxref("opacity")}} of placeh #### HTML ```html - - + + ``` #### CSS diff --git a/files/en-us/web/css/alternative_style_sheets/index.md b/files/en-us/web/css/alternative_style_sheets/index.md index fde4e09e72e307f..c7913dc017a3f15 100644 --- a/files/en-us/web/css/alternative_style_sheets/index.md +++ b/files/en-us/web/css/alternative_style_sheets/index.md @@ -18,7 +18,7 @@ Firefox lets the user select the stylesheet using the _View > Page Style_ submen ## An example: specifying the alternative stylesheets -The alternate stylesheets are commonly specified using a {{HTMLElement("link")}} element with `rel="alternate stylesheet"` and `title="..."` attributes. For example: +The alternate stylesheets are commonly specified using a {{HTMLElement("link")}} element with `rel="alternate stylesheet"` and `title="…"` attributes. For example: ```html @@ -41,8 +41,8 @@ No matter what style is selected, the rules from the reset.css stylesheet will a Any stylesheet in a document falls into one of the following categories: - **Persistent** (no `rel="alternate"`, no `title=""`): always applies to the document. -- **Preferred** (no `rel="alternate"`, with `title="..."` specified): applied by default, but {{domxref("StyleSheet.disabled", "disabled", "", 1)}} if an alternate stylesheet is selected. **There can only be one preferred stylesheet**, so providing stylesheets with different title attributes will cause some of them to be ignored. -- **Alternate** (`rel="alternate stylesheet"`, `title="..."` must be specified): disabled by default, can be selected. +- **Preferred** (no `rel="alternate"`, with `title="…"` specified): applied by default, but {{domxref("StyleSheet.disabled", "disabled", "", 1)}} if an alternate stylesheet is selected. **There can only be one preferred stylesheet**, so providing stylesheets with different title attributes will cause some of them to be ignored. +- **Alternate** (`rel="alternate stylesheet"`, `title="…"` must be specified): disabled by default, can be selected. When style sheets are referenced with a `title` attribute on the {{HTMLElement("link", "<link rel=\"stylesheet\">")}} or {{HTMLElement("style")}} element, the title becomes one of the choices offered to the user. Style sheets linked with the same `title` are part of the same choice. Style sheets linked without a `title` attribute are always applied. diff --git a/files/en-us/web/css/border-radius/index.md b/files/en-us/web/css/border-radius/index.md index 77ef9bc717ddcaf..db18bf9d8c619f0 100644 --- a/files/en-us/web/css/border-radius/index.md +++ b/files/en-us/web/css/border-radius/index.md @@ -163,7 +163,7 @@ For example: ```css border-radius: 1em/5em; -/* ... is equivalent to: */ +/* It is equivalent to: */ border-top-left-radius: 1em 5em; border-top-right-radius: 1em 5em; border-bottom-right-radius: 1em 5em; @@ -173,7 +173,7 @@ border-bottom-left-radius: 1em 5em; ```css border-radius: 4px 3px 6px / 2px 4px; -/* ... is equivalent to: */ +/* It is equivalent to: */ border-top-left-radius: 4px 2px; border-top-right-radius: 3px 4px; border-bottom-right-radius: 6px 2px; 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 072437115829383..4d31032af0ab37f 100644 --- a/files/en-us/web/css/box-decoration-break/index.md +++ b/files/en-us/web/css/box-decoration-break/index.md @@ -63,22 +63,23 @@ The `box-decoration-break` property is specified as one of the keyword values li An inline element that contains line breaks styled with: -```css -.example { - background: linear-gradient(to bottom right, yellow, green); - box-shadow: - 8px 8px 10px 0px deeppink, - -5px -5px 5px 0px blue, - 5px 5px 15px 0px yellow; - padding: 0em 1em; - border-radius: 16px; - border-style: solid; - margin-left: 10px; - font: 24px sans-serif; - line-height: 2; -} - -... +```html + +… The
quick
orange fox ``` diff --git a/files/en-us/web/css/content-visibility/index.md b/files/en-us/web/css/content-visibility/index.md index 7be1dee7af34a8d..bd6cac5178f57b8 100644 --- a/files/en-us/web/css/content-visibility/index.md +++ b/files/en-us/web/css/content-visibility/index.md @@ -65,11 +65,11 @@ section { contain-intrinsic-size: 0 500px; } -
... -
... -
... -
... -... +
… +
… +
… +
… +… ``` ### Using hidden to manually manage visibility @@ -89,10 +89,10 @@ The following example shows that it is possible to manage visibility in script. contain: style layout paint; } -