An effort to improve accessibility documentation for WordPress officially kicked off during Contributor Day at WordCamp Europe 2025 in Basel. Led by Rian Rietveld (web accessibility specialist) and Joe Dolson (member of the WordPress Accessibility team, plug-in developer, and web accessibility consultant), the project aims to reorganize, rewrite, and expand the existing Accessibility Handbook. Rian Rietveld had earlier talked about improving the WordPress accessibility documentation.
How the Accessibility Documentation Project Will Take Shape
The core focus of the project will be in bringing clarity and relevance to WordPress’s accessibility documentation, as stated, “ We are going to work on up to date and well maintained information for WordPress, about what is needed to deliver accessible work and how to properly test for accessibility. With clear do’s and don’ts, practical examples, and easy-to-follow documentation.”
Rian also shared how the documentation effort will be set up, from where the content will be hosted to how the community can contribute and how quality will be maintained, “ We update and add content in the in the current Accessibility Handbook. …..The content will be moved from the current WordPress pages to markdown files in GitHub.
We want to set this up as an open source project, everyone with accessibility knowledge can contribute to the documentation…..”
The work ahead involves migrating existing content to GitHub, reorganizing the handbook’s structure, and inviting community input through a survey. A GitHub project will track tasks, making it easier for contributors to join in. With regard to the progress of the project, Rian will share an update every two weeks.
As per the roadmap overview, from June to October 2025, the team will launch the GitHub project, move existing content, send out a community survey, and begin rewriting and restructuring the documentation, and so on. From November onward, the focus will shift to ongoing updates, reviews, and community contributions.