Moving beyond empathy: a11y in documentation
summary
Argues that empathy alone is insufficient and documents must use concrete accessibility practices including semantic HTML, matching alt and aria text to product labels, and testing with people who have disabilities and with assistive tech like screen readers. Cites numbers: 4.13 billion internet users, about 1 in 4 Black adults has a disability, and WCAG contrast guidance with the WebAIM contrast checker. Notes a real redesign that caused migraines and seizures despite 100 testers, and urges updating style guides and A/B testing docs.
AI-written summary · about
chapters (14)
- 0:00Start
- 0:23Developer Empathy
- 5:39Universal Design Concept
- 7:56Inclusive Language
- 8:13Define Your Jargon
- 9:48Use Gender-Neutral Pronouns
- 10:20Informative Link Text
- 14:47Avoid Ambiguity
- 21:14Readability
- 21:50Semantic Html
- 28:11Culture of Accessibility and Accountability
- 30:25Style Guide
- 30:49Review Accessibility Principles and Design Guidelines
- 31:51Resources
related talks
25mBuilding empathy and accessible apps
38mA11y-Friendly Documentation
40mThe Importance of #a11y-ship
32mBuilding Empathy and Accessible Apps
36mThe Human Side of Accessibility
28mBuilding in accessibility for broader value to all
37mAccessibility Matters: Creating a Better Web
13mDemystifying Web Accessibility