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 WCAG and ARIA intro #126

Merged
merged 6 commits into from
Jun 28, 2023
Merged
Changes from 2 commits
Commits
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
35 changes: 31 additions & 4 deletions docs/resources/useful-resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,38 @@

🔔 Looking for [accessibility docs?](../accessibility-docs)

## Standards and resources
One of our goals is to collect information about accessibility and create documentation to empower the Jupyter community to help us make our software accessible. Please use this section to begin to aggregate relevant accessibility third party standards, guides, and documentation.

One of our goals is to collect information about accessibility and create documentation to empower the Jupyter community
to help us make our software accessible. Please use this section to begin to aggregate relevant third party standards,
guides, and documentation related to this:
## Accessibility guidelines

The World Wide Web Consortium (W3C) publishes a number of international recognized technical guidelines, like the Web Accessibility Initiative (WAI) and XHTML standards. These guidelines assure that a given website can be accessed and consumed by as many people as possible.

### Accessible Rich Internet Applications (WAI-ARIA)

[WAI-ARIA](https://www.w3.org/WAI/standards-guidelines/aria/) provides a route to make Web content and applications more accessible, it specifically targets dynamic content and advanced user interface controls that are normally developed in JavaScript, HTML and other related technologies. A website that doesn't implement this guideline will not be accessible to some users with disabilities, specially the ones that rely on a screen reader or cannot use the mouse.
steff456 marked this conversation as resolved.
Show resolved Hide resolved

Is important to remember that links, buttons and form elements are the only elements that can receive focus in HTML. Meaning that lists, paragraphs, `div` or `span`, will never get focus from the keyboard making them not accessible to users that are not using a mouse. This is where WAI-ARIA provides Web developers with techniques to enable keyboard users have a structure, making their websites more navigable. This guideline also include modules for Graphics and Digital Publishing.

steff456 marked this conversation as resolved.
Show resolved Hide resolved
More info:

- [WAI-ARIA standard](https://www.w3.org/TR/wai-aria/)
- [ARIA Authoring Practices Guide (APG)](https://www.w3.org/WAI/ARIA/apg/)
- [WAI-ARIA 1.1 Standard](https://www.w3.org/TR/wai-aria-1.1/)

### Web Content Accessibility Guidelines (WCAG)

The WCAG is a technical standard that takes care of the information that is in the website. This includes natural information, like text, images and sounds, and code or markup that specify structure and presentation.
trallard marked this conversation as resolved.
Show resolved Hide resolved

This standard is stable and does not change after it is published. The latest version WCAG 2.2, has 13 guidelines organized under four principles: perceivable, operable, understandable, and robust. Each guideline has a testable success criteria for conformance that can vary from A, AA, and AAA.
steff456 marked this conversation as resolved.
Show resolved Hide resolved

More info:

- [WCAG intro](https://www.w3.org/WAI/standards-guidelines/wcag/)
steff456 marked this conversation as resolved.
Show resolved Hide resolved
- [A glance of WCAG 2.1](https://www.w3.org/WAI/standards-guidelines/wcag/glance/)
- [Four principles of accessibility](https://www.w3.org/WAI/WCAG21/Understanding/intro#understanding-the-four-principles-of-accessibility)
- [Levels of conformance](https://www.w3.org/WAI/WCAG21/Understanding/conformance#levels)

### More resources

- [Web Content Accessibility Guidelines 2.1](https://www.w3.org/TR/WCAG21/) - W3C Recommendation
steff456 marked this conversation as resolved.
Show resolved Hide resolved
- [The A11y Project](https://a11yproject.com/)
steff456 marked this conversation as resolved.
Show resolved Hide resolved
Expand Down