What is the most efficient and effective way to describe a accessibility issue that you have just run into when testing or maybe even just using a web site / web application or maybe even a mobile app?
As a accessibility tester I want to document accessibility problems in the most effective way possible, so that developers and designers can make it work for all users.
random QA engineer after accessibility test
Well – we can again be thankful to W3C and Web Accessibility Initiative experts because this is also thought of when they went through all the phases of improving their webpages and adding value to them:
WCAG-EM Report Tool Website Accessibility Evaluation Report Generator (opens in new window) is the way to start when you have to think about accessibility evaluation and reporting it in a most efficient way.
Just a spoiler, it boils down to the following:
- Map the scope – scope identification is the key for a good start, what are our goals? Are they WCAG 2.1 on level AAA? What is our main target public, personas if you will, do we have the capacity to test with real users,…
- Concentrate – there are some pages / parts that are popular and must work and there are some pages / parts that are probably not seen at all. Do a research, use your analytics tools, then do a manual research, be an explorer, plant some flags and reorder them by priority (value to user, business value,…),…
- Audit – use automatic tools at first, they should catch at least the obvious (ideally should be solved when developing and not at the end of the timeline, continuous integration should prevent commiting them to your main branch at least), use a keyboard, screen-reader combined with browser, follow checklists,…
- Report, start with simple and understandable summary. Everybody, also non-technical people should understand the problem. Then continue with technical details an if possible come with suggestions for a fix. Rely on ARIA guidelines as much as possible, so that person(s) resolving issue will get their acceptance criteria and also learn from them…
These points here are my own and I am sure that can be improved, so please read more about the WCAG-EM Report Tool Website Accessibility Evaluation Report Generator (opens in new window) and make your own opinion (and when you do – make sure you share it with everybody 😀 ).