|
@@ -128,11 +128,11 @@ A number of built-in tools and additional resources are available to help create
|
|
|
|
|
|
### Built-in accessibility checker
|
|
|
|
|
|
-Wagtail includes an accessibility checker built into the [user bar](wagtailuserbar_tag). The checker can help authors create more accessible websites in compliance with the Web Content Accessibility Guidelines (WCAG) 2.0 and the Authoring Tool Accessibility Guidelines (ATAG) 2.0.
|
|
|
+Wagtail includes an accessibility checker built into the [user bar](wagtailuserbar_tag). The checker can help authors create more accessible websites following best practices and accessibility standards like [WCAG](https://www.w3.org/WAI/standards-guidelines/wcag/).
|
|
|
|
|
|
-The checker is based on the [Axe](https://github.com/dequelabs/axe-core) testing engine and scans the loaded page for errors, displaying the results in the GUI.
|
|
|
+The checker is based on the [Axe](https://github.com/dequelabs/axe-core) testing engine and scans the loaded page for errors.
|
|
|
|
|
|
-By default, the checker includes the following rules that are among the most common and critical accessibility issues to be violated by editors in Wagtail:
|
|
|
+By default, the checker includes the following rules to find common accessibility issues in authored content:
|
|
|
|
|
|
- `button-name`: `<button>` elements must always have a text label.
|
|
|
- `empty-heading`: This rule checks for headings with no text content. Empty headings are confusing to screen readers users and should be avoided.
|
|
@@ -141,7 +141,7 @@ By default, the checker includes the following rules that are among the most com
|
|
|
- `heading-order`: This rule checks for incorrect heading order. Headings should be ordered in a logical and consistent manner, with the main heading (h1) followed by subheadings (h2, h3, etc.).
|
|
|
- `input-button-name`: `<input>` button elements must always have a text label.
|
|
|
- `link-name`: `<a>` link elements must always have a text label.
|
|
|
-- `p-as-heading`: This rule checks for paragraphs that are styled as headings. Paragraphs should not be styled as headings, as this can cause confusion for users who rely on headings to navigate content.
|
|
|
+- `p-as-heading`: This rule checks for paragraphs that are styled as headings. Paragraphs should not be styled as headings, as they don’t help users who rely on headings to navigate content.
|
|
|
|
|
|
### wagtail-accessibility
|
|
|
|