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

Add top guides section to a11y intro + a11y content updates #6059

Merged
merged 30 commits into from
Jan 2, 2025
Merged
Changes from 3 commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
62d333e
Add top guides section to a11y intro
jennifer-shehane Dec 26, 2024
06ad458
lint
jennifer-shehane Dec 26, 2024
3ff2287
Fix link
jennifer-shehane Dec 26, 2024
6829ef4
Add how it works
jennifer-shehane Dec 27, 2024
e0815c5
Fix images where noBorder didn't do anything
jennifer-shehane Dec 27, 2024
f2f7a9b
Update icon types
jennifer-shehane Dec 27, 2024
5273eef
lint
jennifer-shehane Dec 27, 2024
0ab537a
content updates
jennifer-shehane Dec 27, 2024
fe98646
lint
jennifer-shehane Dec 27, 2024
8b7c7d4
More content updates
jennifer-shehane Dec 27, 2024
f9b296b
lint + reduce img sizes
jennifer-shehane Dec 27, 2024
91b3f48
Update docs/accessibility/core-concepts/accessibility-score.mdx
jennifer-shehane Dec 31, 2024
02bba6e
Update docs/accessibility/core-concepts/accessibility-score.mdx
jennifer-shehane Dec 31, 2024
151d565
Update docs/accessibility/core-concepts/how-it-works.mdx
jennifer-shehane Dec 31, 2024
1327199
Update docs/accessibility/core-concepts/run-level-reports.mdx
jennifer-shehane Dec 31, 2024
4673565
Update docs/accessibility/guides/maintain-accessibility.mdx
jennifer-shehane Dec 31, 2024
a1399e2
Update docs/accessibility/core-concepts/run-level-reports.mdx
jennifer-shehane Dec 31, 2024
fac57e4
Update docs/accessibility/guides/maintain-accessibility.mdx
jennifer-shehane Dec 31, 2024
d914638
Update docs/accessibility/guides/maintain-accessibility.mdx
jennifer-shehane Dec 31, 2024
b2595de
Update docs/accessibility/guides/maintain-accessibility.mdx
jennifer-shehane Dec 31, 2024
c7f4470
Merge branch 'main' into top-guides-a11y
jennifer-shehane Jan 2, 2025
d52f030
add back css selectors description
jennifer-shehane Jan 2, 2025
867cf3b
Merge branch 'top-guides-a11y' of https://github.com/cypress-io/cypre…
jennifer-shehane Jan 2, 2025
09bd7ba
Update wording to be more descriptive
jennifer-shehane Jan 2, 2025
8a475df
Update docs/accessibility/core-concepts/run-level-reports.mdx
jennifer-shehane Jan 2, 2025
dbfc417
Update docs/accessibility/guides/accessibility-automation.mdx
jennifer-shehane Jan 2, 2025
511936b
add aria labels to card links
jennifer-shehane Jan 2, 2025
5875372
Merge branch 'top-guides-a11y' of https://github.com/cypress-io/cypre…
jennifer-shehane Jan 2, 2025
b522856
Add focus style to guides card
jennifer-shehane Jan 2, 2025
8eace98
lint
jennifer-shehane Jan 2, 2025
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
2 changes: 1 addition & 1 deletion docs/accessibility/core-concepts/run-level-reports.mdx
Original file line number Diff line number Diff line change
@@ -91,7 +91,7 @@ Attributes for each rule include:
You can filter Views and Rules in accessibility reports by:

- **Rule severity**: Critical, serious, moderate, or minor.
- **Rules**: WCAG 2.1 A, WCAG 2.1AA, or Best practices.
- **Rules**: WCAG 2.1 A, WCAG 2.1 AA, or Best Practices.
- **Element status**: Failed, inconclusive, or other (other includes ignored elements and rules, 100% passing views and rules, and inapplicable rules).
- **Name**: Search for specific URLs or paths to filter the views or specific names to filter rules.

2 changes: 1 addition & 1 deletion docs/accessibility/guides/accessibility-automation.mdx
Original file line number Diff line number Diff line change
@@ -17,7 +17,7 @@ Cypress Accessibility runs Axe Core® checks on every significant state and vari
Accessibility can be thought of as three progressive levels:

- **Basic Usability**: This is the threshold at which a disabled user is likely to be able to make substantial progress through the application, but may still hit major barriers or usability issues. If your contact forms and issue reporting systems are accessible, you will be able to learn about these problems from actual users. Paying attention to issues reported by Cypress and Axe Core® should help you to this point.
- **WCAG Conformance**: Automated tools like Axe Core® catch up to [57% of accessibility issues that would appear in a manual audit](https://www.deque.com/blog/automated-testing-study-identifies-57-percent-of-digital-accessibility-issues/), but human assessment is essential for validating conformance. Conformance with the WCAG is often the standard set by legislation and regulation related to web accessibility. If your goal is regulatory compliance, this is the bar. No generic automation tool can "prove" compliance with this standard, it **requires** human assessment.
- **WCAG Conformance**: Automated tools like Axe Core® detect many significant accessibility barriers, but human assessment is essential for validating conformance with the Web Content Accessibility Guidelines (WCAG). This is often the standard set by legislation and regulation related to web accessibility. If your goal is regulatory compliance, this is the bar. No generic automation tool can "prove" compliance with this standard, it **requires** human assessment.
- **Good User Experience**: This needs to be validated by actual disabled users who are daily users of assistive technology. It's entirely possible to have a website that passes the first two levels, and still offers a poor user experience.

Accessibility is about communicating the nature and structure of the application, and the available actions and information, in a way that allows disabled users to independently understand the interface and complete all tasks. The [POUR principles](https://www.24a11y.com/2019/pour-the-foundation-first/) (Perceivable, Operable, Understandable, Robust) form the foundation for effective accessibility beyond specific tests or checks. While Axe Core® tells us about many genuine accessibility barriers, it's important to leverage that information into making good decisions about accessibility and providing a truly equal experience.