A11y-Friendly Documentation
Readings
The A11y Project explains what the heck "a11y" actually is.
An excellent book from Laura Kalbag that covers everything from what it's like to use the web with a disability to a11y testing your websites.
According to the World Health Organization, over one billion people globally need an assistive device.
Dave Rupert describes the four categories of accessibility.
The W3 outlines the unexpected business perks of building accessible websites.
Florian Beijers, who has been blind since birth, talks about how he learned to code and the challenges he faced.
While this article is also by Laura Kalbag, it includes a quote from Anne Gibson that perfectly explains why you should care about building accessible websites even if you're not the one writing the code.
In September 2018, MDN hosted an a11y hackathon for their web docs and this blog post talks about the outcomes of that weekend.
The design principles enforced by the UK Government, with the link skipping directly to number 6.
Tools
Desktop app that allows you to quickly grayscale your screen or check it from the perspective of various types of colorblindness.
By putting in the hex of your background color, foreground color and font weight, you can see if your text will be compliant with accessibility standards.
A web app (and linter) that highlights problematic words/sentences and offers suggestions. You want to aim for a Grade 8 reading level or lower.
Internationally recognized, adopted standards produced by the W3C to help us build a more accessible web.
Additional developer tools with features like an accessibility picker and highlighting of UI items.
An open source rules library for a11y testing.
An evaluation tool that provides visual feedback about the accessibility of your web content by injecting icons and indicators into your page.
Thorough checklist that you can use, reference and adapt for your own project.
π©βπ»
Assistive Technologies
Code Examples
Documentation Examples
For keyboard navigation, focus indicators and skip links:
π¦ MDN Web Docs
Colorblind-friendly:
Public documentation accessibility policy:
Mentioned Talks
Detailed information about building accessible SVG charts.
Straightforward techniques and approaches to plain language in documentation.