a 1 1 y

Mike Mai’s Web Accessibility Manual


  1. Honest

    Constantly keep yourself honest. There are 1.3 billion people with significant disabilities in the world. Never use accessibility overlay or widget solutions to shove dirt under the couch. Fix accessibility issues in the foundation, whether that be the HTML, the visual design, or the company culture.

  2. Usable

    There are more than a dozen screen readers and other assistive technologies. Mouse and keyboard are not the only input devices. Your website should be friendly to a wide range of users: screen reader users, screen magnifier users, speech-to-text users, etc.

  3. Efficient

    Consider this: 42 million Americans don’t have high-speed internet according to NPR. Do you really need to build every website with whatever heavy JS-framework-of-the-week? Why not build with just lean and mean HTML? Which leads to the final principle…

  4. Semantic

    96.3% of the top million websites have detectable accessibility issues as of 2023, most of the issues are related to bad HTML structure. Well-crafted visual hierarchy also needs well-crafted meaningful code. Don’t neglect what’s under the hood.



  1. Define

    Accessibility needs a seat at the table. It is never going to work without manager buy-ins. Teach empathy and encourage everyone to do the right thing. Define requirements from top to bottom.

  2. Build

    Design and development needs a lot of attention to details. Creatives should create extensive accessibility annotations for dev hand-offs and engineers should learn the correct technical techniques to bring accessible designs to life.

  3. QA

    QA engineers not only need to be able to perform visual regression, cross browser, and screen reader tests, they also need to know how to code. It is just as important to spot bad code—especially bad HTML—and recommend accessible fixes.

  4. Educate

    Continuous education is crucial to implementing an accessible and inclusive company culture. Run empathy workshops, creative workshops, and technical workshops periodically to remind people why accessibility is important.





Lastly, I leave you with something fun. Enjoy this well curated list of cool tunes while you work on accessibility. Maybe after repeated listening, you will remember the song names in the track list? đŸ˜œ