A11y Need Is Love (But Accessible Docs Help Too)
summary
Argues that accessibility belongs in the foundation of docs not as a cherry on top, using the PyData Sphinx Theme audit and fixes as proof: runs Microsoft Accessibility Insights, finds 33 failed instances (32 are color-contrast), converts issues into specific GitHub tickets, and implements a reusable color system 50–900 shades plus non-color cues (underlines) and 2px contrast-aware focus outlines. Publishes a Figma design system and merges defaults into the theme (visible in v13+), which reduces repeated regressions and speeds future fixes.
AI-written summary · about
chapters (11)
- 0:00Introduction
- 1:13Human needs and accessibility
- 3:02Accessibility foundation
- 6:17Documentation accessibility
- 8:25Accessibility audits
- 12:00PyData Sphinx theme case
- 15:09Color contrast and states
- 21:54Reusable accessibility systems
- 22:56Live accessibility audit
- 30:29Recap and key takeaways
- 32:15Question and answer session
related talks
59mImproving Accessibility Through Design Systems
19mCommit to Change: How to Increase Accessibility in Your Favorite Open Source Projects
30mDocs For All: Improving Open Source Accessibility
38mA11y-Friendly Documentation
32mBuilding Empathy and Accessible Apps
37mMoving beyond empathy: a11y in documentation
36mThe Human Side of Accessibility
46mThis Talk Has Been Disabled