From d2c27844a6587d593c62ace6d01298dfba7db81f Mon Sep 17 00:00:00 2001 From: Thibaud Colas Date: Fri, 9 Jul 2021 15:32:28 +0100 Subject: [PATCH] Update accessibility targets with links to known issues --- docs/contributing/developing.rst | 29 +++++++++++++++++------------ 1 file changed, 17 insertions(+), 12 deletions(-) diff --git a/docs/contributing/developing.rst b/docs/contributing/developing.rst index 12f6c56aa2..9a1837ac78 100644 --- a/docs/contributing/developing.rst +++ b/docs/contributing/developing.rst @@ -213,19 +213,14 @@ Safari Windows All Accessibility targets --------------------- -We want to make Wagtail accessible for users of a wide variety of assistive technologies. The specific standard we aim for is `WCAG2.1 `_, AA level. Wagtail’s administration user interface isn’t accessible at the moment (see `issue #4199 `_), but here are specific assistive technologies we aim to test for, and ultimately support: +We want to make Wagtail accessible for users of a wide variety of assistive technologies. The specific standard we aim for is `WCAG2.1 `_, AA level. Here are specific assistive technologies we aim to test for, and ultimately support: -============= ==================== -Type Assistive technology -============= ==================== -Screen reader `NVDA `_ on Windows with Firefox ESR -Screen reader `VoiceOver `_ on macOS with Safari -Magnification `Windows Magnifier `_ -Magnification macOS Zoom -Voice control Windows Speech Recognition -Voice control macOS Dictation -Screen reader Mobile `VoiceOver `_ on iOS, or `TalkBack `_ on Android -============= ==================== +* `NVDA `_ on Windows with Firefox ESR +* `VoiceOver `_ on macOS with Safari +* `Windows Magnifier `_ and macOS Zoom +* Windows Speech Recognition and macOS Dictation +* Mobile `VoiceOver `_ on iOS, or `TalkBack `_ on Android +* Windows `High-contrast mode `_ We aim for Wagtail to work in those environments. Our development standards ensure that the site is usable with other assistive technologies. In practice, testing with assistive technology can be a daunting task that requires specialised training – here are tools we rely on to help identify accessibility issues, to use during development and code reviews: @@ -233,6 +228,16 @@ We aim for Wagtail to work in those environments. Our development standards ensu * `Axe `_ Chrome extension for more comprehensive automated tests of a given page. * `Accessibility Insights for Web `_ Chrome extension for semi-automated tests, and manual audits. +Known accessibility issues +-------------------------- + +Wagtail’s administration interface isn’t fully accessible at the moment. We actively work on fixing issues both as part of ongoing maintenance and bigger overhauls. To learn about known issues, check out: + +* The `WCAG2.1 AA for CMS admin `_ issues backlog. +* Our `2021 accessibility audit `_. + +The audit also states which parts of Wagtail have and haven’t been tested, how issues affect WCAG 2.1 compliance, and the likely impact on users. + Compiling static assets ~~~~~~~~~~~~~~~~~~~~~~~