From 4c655bab8d16a3bbf8b3d361b96c0d8dc9192c1c Mon Sep 17 00:00:00 2001 From: Stephannie Jimenez Date: Tue, 25 Apr 2023 13:07:59 -0500 Subject: [PATCH 1/5] Add WCAG and ARIA intro and more resources --- docs/resources/useful-resources.md | 35 ++++++++++++++++++++++++++---- 1 file changed, 31 insertions(+), 4 deletions(-) diff --git a/docs/resources/useful-resources.md b/docs/resources/useful-resources.md index 7ca7e1b..680a14e 100644 --- a/docs/resources/useful-resources.md +++ b/docs/resources/useful-resources.md @@ -1,10 +1,37 @@ # Useful Jupyter Accessibility Resources -## 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. + +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. + +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. + +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. + +More info: + +- [WCAG intro](https://www.w3.org/WAI/standards-guidelines/wcag/) +- [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 - [The A11y Project](https://a11yproject.com/) From fad4b0594273a0614df8a8d376138edbe9cd9317 Mon Sep 17 00:00:00 2001 From: Stephannie Jimenez Gacha Date: Tue, 13 Jun 2023 12:13:17 -0500 Subject: [PATCH 2/5] Apply suggestions from code review Co-authored-by: Isabela Presedo-Floyd <50221806+isabela-pf@users.noreply.github.com> --- docs/resources/useful-resources.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/resources/useful-resources.md b/docs/resources/useful-resources.md index 9b8cbaa..b3b9ac0 100644 --- a/docs/resources/useful-resources.md +++ b/docs/resources/useful-resources.md @@ -14,6 +14,8 @@ The World Wide Web Consortium (W3C) publishes a number of international recogniz 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. +ARIA is an additional layer to web content, not a required layer. Though ARIA is powerful, it is important to remember that misused ARIA can make a worse experience for assistive tech users, especially screen reader users. It is often warned that "[No ARIA is better than Bad ARIA](https://www.w3.org/WAI/ARIA/apg/practices/read-me-first/)." Doing relevant research before using ARIA and testing results with screen readers is especially wise here. + More info: - [WAI-ARIA standard](https://www.w3.org/TR/wai-aria/) @@ -24,10 +26,11 @@ More info: 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. -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. +This standard is stable and does not change after it is published. The latest draft, [WCAG 2.2](https://www.w3.org/TR/WCAG22/), 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. Until WCAG 2.2 formally becomes a standards document, [WCAG 2.1](https://www.w3.org/TR/WCAG21/) remains the most up to date standard. More info: +- [Web Content Accessibility Guidelines 2.1](https://www.w3.org/TR/WCAG21/) - The current W3C Recommendation - [WCAG intro](https://www.w3.org/WAI/standards-guidelines/wcag/) - [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) @@ -35,8 +38,14 @@ More info: ### More resources -- [Web Content Accessibility Guidelines 2.1](https://www.w3.org/TR/WCAG21/) - W3C Recommendation +- [Accessibility Weekly Newsletter Archives](https://a11yweekly.com/issues/) - [The A11y Project](https://a11yproject.com/) + +## Accessibility Legislature + +Many countries have laws that specify the ways in which they expect digital content to be accessible. Some of these laws require that software meet their accessibility guidelines to be used in specific places, like schools. For example, [Section 508](https://www.section508.gov/about-us/) compliance is important in the U.S. + +Depending on the project and where in the world it is intended for use, there may be more specific accessibility resources.It's worth noting that several digital accessibility laws globally do draw on the work of the W3C including WCAG. - [18F Accessibility Guide](https://accessibility.18f.gov/) - [The tota11y toolbar](https://khan.github.io/tota11y/) is a lightweight javascript toolbar for quick a11y analysis. - [The WAVE tool](http://wave.webaim.org/report#/http://z2jh.jupyter.org/) is a web analyzer for page accessibility. From fdbd6857b105191f69426d4e3d73fed5ee15d78c Mon Sep 17 00:00:00 2001 From: Stephannie Jimenez Date: Tue, 13 Jun 2023 12:21:47 -0500 Subject: [PATCH 3/5] lowercase web --- docs/resources/useful-resources.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/resources/useful-resources.md b/docs/resources/useful-resources.md index b3b9ac0..83fd246 100644 --- a/docs/resources/useful-resources.md +++ b/docs/resources/useful-resources.md @@ -10,9 +10,9 @@ The World Wide Web Consortium (W3C) publishes a number of international recogniz ### 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. +[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. -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. +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. ARIA is an additional layer to web content, not a required layer. Though ARIA is powerful, it is important to remember that misused ARIA can make a worse experience for assistive tech users, especially screen reader users. It is often warned that "[No ARIA is better than Bad ARIA](https://www.w3.org/WAI/ARIA/apg/practices/read-me-first/)." Doing relevant research before using ARIA and testing results with screen readers is especially wise here. @@ -43,9 +43,9 @@ More info: ## Accessibility Legislature -Many countries have laws that specify the ways in which they expect digital content to be accessible. Some of these laws require that software meet their accessibility guidelines to be used in specific places, like schools. For example, [Section 508](https://www.section508.gov/about-us/) compliance is important in the U.S. +Many countries have laws that specify the ways in which they expect digital content to be accessible. Some of these laws require that software meet their accessibility guidelines to be used in specific places, like schools. For example, [Section 508](https://www.section508.gov/about-us/) compliance is important in the U.S. -Depending on the project and where in the world it is intended for use, there may be more specific accessibility resources.It's worth noting that several digital accessibility laws globally do draw on the work of the W3C including WCAG. +Depending on the project and where in the world it is intended for use, there may be more specific accessibility resources.It's worth noting that several digital accessibility laws globally do draw on the work of the W3C including WCAG. - [18F Accessibility Guide](https://accessibility.18f.gov/) - [The tota11y toolbar](https://khan.github.io/tota11y/) is a lightweight javascript toolbar for quick a11y analysis. - [The WAVE tool](http://wave.webaim.org/report#/http://z2jh.jupyter.org/) is a web analyzer for page accessibility. From 1aebdb3603e8e05d974af3991218f9037efb3d2f Mon Sep 17 00:00:00 2001 From: Tania Allard Date: Thu, 22 Jun 2023 17:05:13 +0100 Subject: [PATCH 4/5] Update docs/resources/useful-resources.md Co-authored-by: Stephannie Jimenez Gacha --- docs/resources/useful-resources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/resources/useful-resources.md b/docs/resources/useful-resources.md index 83fd246..b9a160c 100644 --- a/docs/resources/useful-resources.md +++ b/docs/resources/useful-resources.md @@ -24,7 +24,7 @@ More info: ### 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. +The WCAG is a technical standard that takes care of the information that is in the website. This includes information like text, images and sounds, and code or markup that specify structure and presentation. This standard is stable and does not change after it is published. The latest draft, [WCAG 2.2](https://www.w3.org/TR/WCAG22/), 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. Until WCAG 2.2 formally becomes a standards document, [WCAG 2.1](https://www.w3.org/TR/WCAG21/) remains the most up to date standard. From afec99116049e3c1573d0a33744b6c34a3d0ce6c Mon Sep 17 00:00:00 2001 From: Tania Allard Date: Thu, 22 Jun 2023 17:06:17 +0100 Subject: [PATCH 5/5] Update docs/resources/useful-resources.md --- docs/resources/useful-resources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/resources/useful-resources.md b/docs/resources/useful-resources.md index b9a160c..7471242 100644 --- a/docs/resources/useful-resources.md +++ b/docs/resources/useful-resources.md @@ -24,7 +24,7 @@ More info: ### Web Content Accessibility Guidelines (WCAG) -The WCAG is a technical standard that takes care of the information that is in the website. This includes information like text, images and sounds, and code or markup that specify structure and presentation. +The WCAG is a technical standard that takes care of information shared through websites. This includes content like text, images and sounds, and code or markup that specify structure and presentation. This standard is stable and does not change after it is published. The latest draft, [WCAG 2.2](https://www.w3.org/TR/WCAG22/), 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. Until WCAG 2.2 formally becomes a standards document, [WCAG 2.1](https://www.w3.org/TR/WCAG21/) remains the most up to date standard.