Record a goose sighting
This is a fictional service, to help you record any sightings of geese (geese are awesome). It's using the GOV.UK Design system, which are WCAG 2.1 AA compliant, and benefits from hundreds of hours of work and testing. However, even if you're using a Design System, stuff can still go wrong...
There are places where the Design System is misused, misimplemented or misunderstood. This has caused accessibility issues, which range across code, design and content - because accessibility issues can be introduced by all of these disciplines. As such, anyone is welcome to have a go and use this as an exercise!
How to use this
The task is to find as many of the accessibility issues in this site as you can in ~20 minutes.
What testing tools to use
I would recommend working through the site in the following order:
- Can you access everything by pressing the tab key?
- Does WAVE show any errors, or highlight any issues with the HTML structure?
- Does the colour contrast tab on WAVE throw up any errors?
- If you run the Dark Mode browser extension, can you see any issues with the site?
Government Digital Services have recently published how to conduct a basic accessibility audit, which is worth a look at too.
Testing like this is a good way to identify basic accessibility issues. It would not replace an audit against WCAG 2.1 to level AA, and its ~50 criteria. Why still do it? These are tests that are quick to run, and it's easier to fix accessibility issues at the start, rather than the end.
How to run locally
This is built using the GOV.UK Prototype Kit.
To run it locally, clone it down, run
npm install and then
npm start. It'll then tell you a port to go to in the browser.
Alternatviely run it via docker & docker-compose
Or get a bash console where you can run
npm cmds via the built container (ensure step 1 above is done)
docker-compose run --rm --service-ports --entrypoint="bash" goose
Run the tests via docker
docker-compose run --rm --entrypoint="npm run test" goose
Resources for further learning
- Udacity Accessibility course - good for futhering knowledge about writing accessible code
- GDS WCAG 2.1 Primer - good for helping you understand the Web Content Accessibility Guidelines
- GDS guidance how to conduct a basic accessibility audit - mentioned above but listed here as well
- a11y weekly - a good weekly newsletter about accessibility
Any other suggestions, free free to add them!