WPa11y documentation meeting

Attending: @travel_girl, @samikeijonen, @sergeybiryukov and @rianrietveld

Goal of the meeting:

Kickoff meeting for rewriting and reorganising the documentation on WordPress.org regarding web accessibility.
We want the documentation set up so that it’s complete, without duplicates, easy to find and put it on places where people actually will read it.

What we agreed on:

  • We will start with our own handbook
  • In the topic spreadsheet we gather topics and assign ourself to write about them
  • We will add topics as we go
  • We will write in Google Docs (Sami opened a directory for this)
  • We can organise the topic later in a logical way before publishing them in the accessibility handbook
  • We report and discuss our work every Thursday in the #accessibility Slack channel
  • The goal is to write one topic a week per person
  • When the topics are added to the handbook, we will review the current documentation on wp.org to see where we can ask the teams to replace/add/modify text to prevent double info and to link to better information.

For the topics we want to keep a template, for example:

  • Topic
  • Short intro with:
    • Good Practice
    • Bad Practice
    • Why
    • Exceptions
  • Examples
  • Resources with links

We don’t want to copy all the info there already is on the web, but point to good info and examples.

If more people want to join in, you are most welcome.


Accessibility Quick Start Guide in draft: needs vetting

The WordPress Accessibility Handbook now has a draft of a Quick Start Guide. The doc needs edits, comments, and vetting.

We intend this as a resource for developers to quickly grab WordPress-oriented code examples and a11y guidelines. Let’s make sure everything is accurate and clearly explained, and that nothing a11y-critical for WP dev is missing. (This process might also help us identify which topics need further explanations in other Handbook sections.)

Please review the draft and leave your comments on this post.

#documention, #handbook

WP a11y docs list

Here’s a collection of all the A11y resources I’ve found at WordPress.org sites (and two Google docs in use for drafting Handbook pages):

Make WordPress Accessible blog

Make WordPress Accessible> Accessibility Handbook

(Draft: outline for A11y Handbook) Accessibility Contributor Handbook

Make WordPress Accessible> Useful Tools

Useful Tools

WordPress Accessibility> Theme Patterns

Docs Handbook> Handbooks Style and Formatting Guide> Accessibility

Handbooks Style and Formatting Guide

Codex> Accessibility

Theme Handbook> Accessibility


Theme Review Handbook> Accessibility


Theme Review Handbook> Accessibility> #resources


Theme Review Handbook> Accessibility> Resources


Theme Directory> accessibility-ready tag

Plugin Directory> WP Accessibility

WP Accessibility

Plugin Directory> Access Monitor

Access Monitor

(Draft: guidelines for Plugins) WordPress A11y Code Standards

Accessibility code standards for WordPress core (similar to above)

Accessibility code standards for WordPress core

#documention, #handbook

Accessibility for Theme Developers: First Draft Complete

I think I’ve finally finished! *gasp* Thank you to everyone who provided earlier feedback and jogged my memory.

Is there anything on the completed page I need to re-word or explain in more detail?

As previously, please post all feedback here rather than on the draft page itself.

#documention, #theme