Skip to content

Commit

Permalink
fix: MD001 Headings should only increment by 1 (mdn#20301)
Browse files Browse the repository at this point in the history
  • Loading branch information
nschonni authored Sep 5, 2022
1 parent 8d76e99 commit 871c718
Show file tree
Hide file tree
Showing 59 changed files with 146 additions and 150 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -272,7 +272,7 @@ There is one last `<input>` type that came to us in early HTML: the file input t

To create a [file picker widget](/en-US/docs/Web/HTML/Element/input/file), you use the {{HTMLElement("input")}} element with its {{htmlattrxref("type","input")}} attribute set to `file`. The types of files that are accepted can be constrained using the {{htmlattrxref("accept","input")}} attribute. In addition, if you want to let the user pick more than one file, you can do so by adding the {{htmlattrxref("multiple","input")}} attribute.

#### Example
### Example

In this example, a file picker is created that requests graphic image files. The user is allowed to select multiple files in this case.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -160,9 +160,9 @@ The blockquote can contain code blocks or other block elements.

Because the text "Note:" or "Warning:" also appears in the rendered output, it has to be sensitive to translations. In practice this means that every locale supported by MDN must supply its own translation of these strings, and the platform must recognize them as indicating that the construct needs special treatment.

#### Examples
### Examples

##### Note
#### Note

```plain
> **Note:** This is how you write a note.
Expand All @@ -185,7 +185,7 @@ This HTML will be rendered as a highlighted box, like:
>
> It can have multiple lines.
##### Warnings
#### Warnings

```plain
> **Warning:** This is how you write a warning.
Expand All @@ -208,7 +208,7 @@ This HTML will be rendered as a highlighted box, like:
>
> It can have multiple paragraphs.
##### Callouts
#### Callouts

```plain
> **Callout:** **This is how you write a callout.**
Expand All @@ -233,7 +233,7 @@ This HTML will be rendered as a highlighted box, like:
>
> It can have multiple paragraphs.
##### Translated warning
#### Translated warning

For example, if we want to use "Warnung" for "Warning" in German, then in German pages we would write:

Expand All @@ -249,7 +249,7 @@ And this will produce:
</div>
```

##### Note containing a code block
#### Note containing a code block

This example contains a code block.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -488,10 +488,10 @@ You can also specify the desired API as the first argument to the macro as shown
The macro calls generate the following tables (and corresponding set of notes):
#### Compatibility table example
### Compatibility table example
{{Compat}}
#### Specifications table examples
### Specifications table examples
{{Specifications}}
Original file line number Diff line number Diff line change
Expand Up @@ -272,14 +272,14 @@ They can also be used to mark up a section on a page.
The [`AvailableInWorkers`](https://github.com/mdn/yari/blob/main/kumascript/macros/AvailableInWorkers.ejs) macro inserts a localized note box indicating that a feature is available in a [Web worker](/en-US/docs/Web/API/Web_Workers_API) context.
You can use the argument `notservice` to indicate that a feature works in web workers except for service workers.

##### Syntax
#### Syntax

```plain
\{{AvailableInWorkers}}
\{{AvailableInWorkers("notservice")}}
```

##### Examples
#### Examples

{{AvailableInWorkers}}
{{AvailableInWorkers("notservice")}}
2 changes: 1 addition & 1 deletion files/en-us/mozilla/firefox/releases/101/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ For more information, see the [full bug list](https://bugzilla.mozilla.org/bugli
- The `content` object (that offered `content.fetch`, `content.XMLHttpRequest`, and `content.WebSocket`) is removed from the content script execution environment.
- Addition of the {{WebExtAPIRef("storage.StorageArea.onChanged")}} event that enables you to listen for changes in content in the `local` and `sync` storage areas ({{bug(1758475)}}).

#### Removals
### Removals

### Other

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/mozilla/firefox/releases/103/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ This article provides information about the changes in Firefox 103 that will aff

## Changes for add-on developers

#### Removals
### Removals

- Removed the ServiceWorker API in WebExtensions (`'serviceWorker' in navigator` now returns false when run inside an extension). ({{bug(1593931)}})

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/mozilla/firefox/releases/104/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ No notable changes.

## Changes for add-on developers

#### Removals
### Removals

### Other

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/mozilla/firefox/releases/105/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ This article provides information about the changes in Firefox 105 that will aff

- Support for defining persistent scripts using {{WebExtAPIRef("scripting")}} has been added. A script is identified as persistent using the `persistAcrossSessions` property in {{WebExtAPIRef("scripting.RegisteredContentScript")}} ({{bug("1751436")}}).

#### Removals
### Removals

### Other

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/mozilla/firefox/releases/106/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ This article provides information about the changes in Firefox 106 that will aff

## Changes for add-on developers

#### Removals
### Removals

### Other

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -90,15 +90,15 @@ From the assistive technology user's perspective, the heading does not exist sin

The following example creates an otherwise non-semantic checkbox element using CSS and JavaScript to handle the checked or unchecked status of the element.

#### HTML
### HTML

```html
<span role="checkbox" id="chkPref" aria-checked="false" onclick="changeCheckbox()" onKeyDown="changeCheckbox(event.keyCode)"
tabindex="0" aria-labelledby="chk1-label"></span>
<label id="chk1-label" onclick="changeCheckbox()" onKeyDown="changeCheckbox(event.keyCode)">Remember my preferences</label>
```

#### CSS
### CSS

```css
[role="checkbox"] {
Expand All @@ -118,7 +118,7 @@ The following example creates an otherwise non-semantic checkbox element using C
}
```

#### JavaScript
### JavaScript

```js
function changeCheckbox(keyCode) {
Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/accessibility/aria/roles/dialog_role/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Marking up a dialog element with the `dialog` role helps assistive technology id

The sections below describe how these two requirements can be met.

#### Labeling
### Labeling

Even though it is not required for the dialog itself to be able to receive focus, it still needs to be labeled. The label given to the dialog will provide contextual information for the interactive controls inside the dialog. In other words, the dialog's label acts like a grouping label for the controls inside it (similar to how a `<legend>` element provides a grouping label for the controls inside a `<fieldset>` element).

Expand Down Expand Up @@ -81,7 +81,7 @@ When the dialog is correctly labeled and focus is moved to an element (often an
## Examples

#### A dialog containing a form
### A dialog containing a form

```html
<div role="dialog" aria-labelledby="dialog1Title" aria-describedby="dialog1Desc">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ When the user clicks on an option, hits <kbd>Space</kbd> when focused on an opti
## Examples

#### Example 1: A single select listbox that uses [`aria-activedescendant`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-activedescendant)
### Example 1: A single select listbox that uses [`aria-activedescendant`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-activedescendant)

The snippet below shows how the listbox role is added directly into the HTML source code.

Expand Down Expand Up @@ -193,7 +193,7 @@ This could have more easily been handled with the native HTML {{HTMLElement('sel
</select>
```

#### More examples
### More examples

- [Scrollable Listbox Example](https://w3c.github.io/aria-practices/examples/listbox/listbox-scrollable.html): Single-select listbox that scrolls to reveal more options, similar to HTML {{HTMLElement('select')}} with `size` attribute greater than one.
- [Collapsible Dropdown Listbox Example](https://w3c.github.io/aria-practices/examples/listbox/listbox-collapsible.html): Single-select collapsible listbox that expands when activated, similar to HTML {{HTMLElement('select')}} with the attribute `size="1"`.
Expand Down
24 changes: 12 additions & 12 deletions files/en-us/web/accessibility/seizure_disorders/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -525,11 +525,11 @@ The `update` media feature is used to query the ability of the output device to

## Developmental & Experimental Features

#### MDN Navigator.doNotTrack
### MDN Navigator.doNotTrack

[From the documentation](/en-US/docs/Web/API/Navigator/doNotTrack): _"Returns the user's do-not-track setting. This is "1" if the user has requested not to be tracked by web sites, content, or advertising"_.

#### Media Queries Level 5
### Media Queries Level 5

EnvironmentMQ (Planned in Media Queries Level 5)

Expand All @@ -538,7 +538,7 @@ EnvironmentMQ (Planned in Media Queries Level 5)
- `environment-blending`
- : From W3C's Draft document, Media Queries Level 5: _"The [`environment-blending`](https://drafts.csswg.org/mediaqueries-5/#descdef-media-environment-blending) media feature is used to query the characteristics of the user's display so the author can adjust the style of the document. An author might choose to adjust the visuals and/or layout of the page depending on the display technology to increase the appeal or improve legibility."_

##### User Preference Media Features (Planned in Media Queries Level 5)
#### User Preference Media Features (Planned in Media Queries Level 5)

[User Preference Media Features](https://drafts.csswg.org/mediaqueries-5/#mf-user-preferences) in [W3C Editor's Draft Media Queries Level 5](https://drafts.csswg.org/mediaqueries-5/) are especially promising in providing user control over media. Here are some highlights:

Expand Down Expand Up @@ -569,7 +569,7 @@ The Web Animations model is intended to provide the features necessary for expre

## See also

#### MDN
### MDN

- [Accessibility: What users can do to browse more safely](/en-US/docs/Web/Accessibility/Accessibility:_What_users_can_to_to_browse_safely)
- [Accessibility: Understanding color and luminance](/en-US/docs/Web/Accessibility/Understanding_Colors_and_Luminance)
Expand All @@ -584,46 +584,46 @@ The Web Animations model is intended to provide the features necessary for expre
- [WebGL: 2D and 3D graphics for the web](/en-US/docs/Web/API/WebGL_API)
- [WebVR API](/en-US/docs/Web/API/WebVR_API)

#### Color
### Color

- [Color Tutorial: describing color](https://colortutorial.design/) Tom Jewett
- [Formula to Determine Brightness of RGB color](https://stackoverflow.com/questions/596216/formula-to-determine-perceived-brightness-of-rgb-color) Stack Exchange Discussion Thread
- [How the Color Red Influences Our Behavior](https://www.scientificamerican.com/article/how-the-color-red-influences-our-behavior/) Scientific American By Susana Martinez-Conde, Stephen L. Macknik on November 1, 2014

#### Discussions
### Discussions

- [Problems with WCAG 2.0 Flash Definition #553](https://github.com/w3c/wcag/issues/553)
- [WCAG 2.1 Understanding 2.3.1 - missing/vague dimension definitions #585](https://github.com/w3c/wcag/issues/585)

#### Epilepsy and Seizures
### Epilepsy and Seizures

- [Shedding Light on Photosensitivity, One of Epilepsy's Most Complex Conditions](https://www.epilepsy.com/stories/shedding-light-photosensitivity-one-epilepsys-most-complex-conditions-0) Epilepsy Foundation: _"Certain individuals are born with special sensitivity to flashing lights or contrasting visual patterns, such as stripes, grids and checkerboards. Because of this condition, their brain will produce seizure-like discharges when exposed to this type of visual stimulation."_
- [Gamma oscillations and photosensitive epilepsy](https://www.sciencedirect.com/science/article/pii/S0960982217304062?via%3Dihub) Current Biology [Volume 27, Issue 9](https://www.sciencedirect.com/journal/current-biology/vol/27/issue/9), 8 May 2017, Pages R336-R338: _"Certain [visual images](https://www.sciencedirect.com/topics/biochemistry-genetics-and-molecular-biology/retina-image), even in the absence of motion or flicker, can trigger seizures in patients with photosensitive epilepsy."_
- [Photosensitive Seizures. Cedars-Sinai](https://www.cedars-sinai.org/health-library/diseases-and-conditions/p/photosensitive-seizures.html) "_Photosensitive seizures are triggered by flashing or flickering lights. These seizures can also be triggered by certain patterns such as stripes._"
- [Photic-and pattern-induced seizures: expert consensus of the Epilepsy Foundation of America Working Group](https://pubmed.ncbi.nlm.nih.gov/16146438/) Eplepsia 2005 Sept, 46(9):1423-5 PubMed.gov NCBI [Harding G](https://pubmed.ncbi.nlm.nih.gov/?term=Harding%20G%5BAuthor%5D&cauthor=true&cauthor_uid=16146438), [Wilkins AJ](https://pubmed.ncbi.nlm.nih.gov/?term=Wilkins%20AJ%5BAuthor%5D&cauthor=true&cauthor_uid=16146438), [Erba G](https://pubmed.ncbi.nlm.nih.gov/?term=Erba%20G%5BAuthor%5D&cauthor=true&cauthor_uid=16146438), [Barkley GL](https://pubmed.ncbi.nlm.nih.gov/?term=Barkley%20GL%5BAuthor%5D&cauthor=true&cauthor_uid=16146438), [Fisher RS](https://pubmed.ncbi.nlm.nih.gov/?term=Fisher%20RS%5BAuthor%5D&cauthor=true&cauthor_uid=16146438); [Epilepsy Foundation of America Working Group](https://pubmed.ncbi.nlm.nih.gov/?term=Epilepsy%20Foundation%20of%20America%20Working%20Group%5BCorporate%20Author%5D).

#### GPII
### GPII

- [Accessibility Master List](https://ds.gpii.net/learn/accessibility-masterlist) Gregg Vanderheiden Ph.D. Editor

#### Harding
### Harding

Along with the PEAT tool, is generally recognized to be one of the two "gold standards" for analyzing flashes.

- [Harding Flash and Pattern Analyzer](https://www.hardingfpa.com)

#### ISO
### ISO

- [IEC 61966-2-2:2003(en)](https://www.iso.org/obp/ui/#iso:std:iec:61966:-2-2:ed-1:v1:en) Multimedia systems and equipment — Colour measurement and management — Part 2-2: Colour management — Extended RGB color space — scRGB

#### Photosensitive Epilepsy Analysis Tool
### Photosensitive Epilepsy Analysis Tool

Along with the Harding tool, is generally recognized to be one of the two "gold standards" for analyzing flashes.

- [Trace Research and Development Center](https://trace.umd.edu/peat/)
- [Using PEAT To Create Seizureless Web Animations](https://www.useragentman.com/blog/2017/04/02/using-peat-to-create-seizureless-web-animations/)

#### W3C
### W3C

- [CSS Color Module Level 3](https://www.w3.org/TR/css-color-3/)
- [Personalization Semantics Explainer 1.0](https://www.w3.org/TR/personalization-semantics-1.0/). Working Draft
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -417,30 +417,30 @@ Within the W3 AGWG there is active discussion and investigation regarding the WC

## Additional Resources

#### MDN
### MDN

- [Accessibility](/en-US/docs/Web/Accessibility)
- [Accessibility learning path](/en-US/docs/Learn/Accessibility)
- [color](/en-US/docs/Web/CSS/color)
- [`<color>`](/en-US/docs/Web/CSS/color_value)
- [Web accessibility for seizures and physical reactions](/en-US/docs/Web/Accessibility/Seizure_disorders)

#### W3C Issues and Discussions
### W3C Issues and Discussions

- [The Visual Contrast Research Group](https://www.w3.org/WAI/GL/task-forces/silver/wiki/Visual_Contrast_of_Text_Subgroup) for WCAG 3.
- [Light and dark text](https://github.com/w3c/silver/issues/261) & WCAG 3.0 contrast (Silver thread #261)
- [Contrast Ratio Math](https://github.com/w3c/wcag/issues/695) and Related Visual Issue thread #695
- [Luminance / Luma confusion](https://github.com/w3c/wcag/issues/236) thread #236
- [Non-sRGB color spaces](https://github.com/w3c/wcag/issues/360), outdated sRGB threshold thread #360

#### W3C Standards and Guidelines
### W3C Standards and Guidelines

- [The latest draft of the new WCAG 3 standards](https://www.w3.org/TR/wcag-3.0/)
- [Ensuring that a contrast ratio of 3:1 is provided for icons](https://www.w3.org/WAI/WCAG21/Techniques/general/G207)
- [Understanding Success Criterion 1.4.3: Contrast (Minimum)](https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html)
- [CSS Color Module Level 3](https://www.w3.org/TR/css-color-3/)
- [CSS Color Module Level 4](https://drafts.csswg.org/css-color-4/)

### Page Source
## Page Source

This page is based largely on the white paper on color and contrast by Andrew Somers, which is being developed for the W3 and Accessibility Guidelines Working Group, used herein by permission. Andrew Somers is an invited expert of the W3 and the AGWG, the author of the WCAG 3 Visual Contrast specifications, and the inventor of the APCA.
Original file line number Diff line number Diff line change
Expand Up @@ -37,13 +37,13 @@ Allowed values are:

In this example we display the text "AVA Ta We" using each of the supported values of the `textRendering` property.

#### HTML
### HTML

```html
<canvas id="canvas" width="700" height="140"></canvas>
```

#### JavaScript
### JavaScript

```js
const canvas = document.getElementById('canvas');
Expand All @@ -62,7 +62,7 @@ ctx.fontKerning = 'none';
ctx.fillText(`AVA Ta We (${ctx.fontKerning})`, 5, 110);
```

#### Result
### Result

Note that the the last string has font kerning disabled, so adjacent characters are evenly spread.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,13 +29,13 @@ The property can be used to get or set the font stretch value.
In this example we display the text "Hello World" using each of the supported values of the `fontStretch` property.
The stretch value is also displayed for each case by reading the property.

#### HTML
### HTML

```html
<canvas id="canvas" width="700" height="310"></canvas>
```

#### JavaScript
### JavaScript

```js
const canvas = document.getElementById('canvas');
Expand Down Expand Up @@ -82,7 +82,7 @@ ctx.fontStretch = 'ultra-expanded';
ctx.fillText(`Hello world (${ctx.fontStretch})`, 5, 290);
```

#### Result
### Result

{{ EmbedLiveSample('Examples', 700, 300) }}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,13 +49,13 @@ Note that there are accessibility concerns with some of these, which are outline
In this example we display the text "Hello World" using each of the supported values of the `fontVariantCaps` property.
The value is also displayed for each case by reading the property.

#### HTML
### HTML

```html
<canvas id="canvas" width="700" height="220"></canvas>
```

#### JavaScript
### JavaScript

```js
const canvas = document.getElementById('canvas');
Expand Down Expand Up @@ -90,7 +90,7 @@ ctx.fontVariantCaps = 'titling-caps';
ctx.fillText(`Hello world (${ctx.fontVariantCaps})`, 5, 200);
```

#### Result
### Result

{{ EmbedLiveSample('Examples', 700, 230) }}

Expand Down
Loading

0 comments on commit 871c718

Please sign in to comment.