Read on Twitter
A little thing I noticed on how important documentation is.
When I put together jest-axe a small library to integrate axe-core with jest.
I put a big disclaimer on it:
"This project does not guarantee what you build is accessible."
When I put together jest-axe a small library to integrate axe-core with jest.
I put a big disclaimer on it:
"This project does not guarantee what you build is accessible."
"The GDS Accessibility team found that only ~30% of issues are found by automated testing."
"Tools like aXe are similar to code linters such as eslint or stylelint: they can find common issues but cannot guarantee what you build works for users."
"Tools like aXe are similar to code linters such as eslint or stylelint: they can find common issues but cannot guarantee what you build works for users."
"You'll also need to:
- test your interface with the assistive technologies that real users use (see also WebAIM's survey results).
- include disabled people in user research."
- test your interface with the assistive technologies that real users use (see also WebAIM's survey results).
- include disabled people in user research."
I just noticed some people have put together blog posts talking about accessibility tools:
- https://medium.com/hackernoon/testing-react-with-jest-axe-and-react-testing-library-accessibility-34b952240f53
- https://codeburst.io/automated-accessibility-testing-tool-a11y-pa11y-jest-storybook-2ad294bfe71a
- https://dev.to/bdougieyo/accessibility-testing-in-react-with-jest-axe-l7k
- https://medium.com/hackernoon/testing-react-with-jest-axe-and-react-testing-library-accessibility-34b952240f53
- https://codeburst.io/automated-accessibility-testing-tool-a11y-pa11y-jest-storybook-2ad294bfe71a
- https://dev.to/bdougieyo/accessibility-testing-in-react-with-jest-axe-l7k
They all mention this disclaimer in one way or another.
In the past I've been very much abe simpson shouts at the clouds meme with no impact, but just this extra bit of documentation has made way more impact than me moaning about things on Twitter.
In the past I've been very much abe simpson shouts at the clouds meme with no impact, but just this extra bit of documentation has made way more impact than me moaning about things on Twitter.
I've been trying to avoid getting angry about things if I don't see any impact and that process of reflecting on why something pisses me off and making the decision to just not bother has definitely helped me.
Links for things mentioned in this thread:
- https://github.com/nickcolley/jest-axe
- https://github.com/dequelabs/axe-core
- https://accessibility.blog.gov.uk/2017/02/24/what-we-found-when-we-tested-tools-on-the-worlds-least-accessible-webpage
- https://www.gov.uk/service-manual/technology/testing-with-assistive-technologies#when-to-test
- https://webaim.org/projects/screenreadersurvey8/#primary
- https://github.com/nickcolley/jest-axe
- https://github.com/dequelabs/axe-core
- https://accessibility.blog.gov.uk/2017/02/24/what-we-found-when-we-tested-tools-on-the-worlds-least-accessible-webpage
- https://www.gov.uk/service-manual/technology/testing-with-assistive-technologies#when-to-test
- https://webaim.org/projects/screenreadersurvey8/#primary
