Survey: Which WP accessibility documentation do you need?

As you probably already know, we will be working on the documentation on accessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) in the WP Accessibility Team’s Handbook. For this we need your feedback.
If you have the time, please fill in the feedback request form so we know what you think is important to read.

Could you please also share this link with your co-workers?

#accessibility, #wp-a11y-docs

X-post: AI Chat Agenda – 12 June 2025

X-comment from +make.wordpress.org/ai: Comment on AI Chat Agenda – 12 June 2025

Start project “Accessibility documentation” on WordCamp Europe 2025.

At the contributor dayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/. of WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Europe in Basel @rianrietveld and @joedolson started the work to update and extend the documentation about accessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) for WordPress. This is what we agreed:

Scope

The current documentation in our Accessibility Handbook needs to be improved on.

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.

Setup

We update and add content in the in the current Accessibility Handbook. On developers.wordpress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/ a section will be created for accessibility specific code examples, for reference in the Handbook.

The content will be moved from the current WordPress pages to markdown files in GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/.

We want to set this up as an open sourceOpen Source Open Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. project, everyone with accessibility knowledge can contribute to the documentation. The accessibility team will project manage and safeguard the quality of the content.

Work

  • The current content in the Handbook will be copied to a GitHub repo on the WPAccessibility GitHub account. We work from there to create the content in markdown.
  • We will conduct a survey in the WordPress community on which documentation they need.
  • The structure of the Handbook will be reorganised to fit the users need better.
  • Once the set up and the main content is ready to go, that repo will be transferred back to the WordPress account and mantained from there.
  • On the WPAccessibility Github account Rian will create and manage a GitHub project with all the work that needs to be done. Such as the content that needs to be rewritten and created. That way it’s easy for more people to contribute and work on different content.
  • There will be a process of reviewing in place, to make sure the content is up to WordPress and accessibility standards.
  • Code examples and other technical documentation will be published in an accessibility section of developers.wordpress.org or will be included in with current developers content, depending on the topic.
  • The updated documentation and requirements for the accessibility-ready tag will be added to a logical place on the themes handbook.

Rian will set up and project manage this work. She will report every two weeks in this blog about the progress.

Roadmap

June – August 2025

  • Set up the GitHub project
  • Set up the GitHub repo on WPAccessibility
  • Transfer the current content of the handbook
  • Send out the survey

September – October 2025

  • Rewrite and restructure the current content
  • Set up a system of reviewing and merge rights
  • Decide on new content and where to add that and create GitHub issues for them

From November 2025 on

  • Maintain the current info and keep thinking about info to add or update
  • Review and if ok merge pull requests from people who contribute
  • Invite more people to work on the content mentioned in the GitHub issues

With many thanks to Milana Cap, Gary Jones and Virginia Ciambriello for the useful discussions during WordCamp Europe.

#accessibility, #make-wordpress-org-updates, #wp-a11y-docs

X-post: Introducing the AI Team – Hallway Hangout Recap

X-comment from +make.wordpress.org/ai: Comment on Introducing the AI Team – Hallway Hangout Recap

X-post: Criteria for Creating or Migrating Repositories under the WordPress GitHub Organization

X-comment from +make.wordpress.org/project: Comment on Criteria for Creating or Migrating Repositories under the WordPress GitHub Organization

Accessibility Team Meeting Agenda: June 04, 2025

This is the proposed agenda for the weekly AccessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) Team meeting on Wednesday, June 04, 2025, 15:00 UTC.

RevisionsRevisions The WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. to the theme accessibility guidelines

WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Europe Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/.

Updates from working groups

  • Design
  • Documentation
  • General
  • GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/
  • Media
  • MetaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress.
  • Themes

Open floor

If you want to have a topic added to the agenda, please mention it in the comments of this post.

The Accessibility Team bug scrub has moved to Tuesdays, 16:00 UTC.

This meeting is held in the #accessibility channel in the Making WordPress SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. (requires registration).

#accessibility, #agenda

X-post: Hallway Hangout: Let’s chat about the new AI team

X-comment from +make.wordpress.org/ai: Comment on Hallway Hangout: Let's chat about the new AI team

Accessibility Team Meeting Agenda: May 07, 2025

This is the proposed agenda for the weekly AccessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) Team meeting on Wednesday, May 07, 2025, 15:00 UTC.

Accessibility Improvements planning for the next major releaseMajor Release A set of releases or versions having the same major version number may be collectively referred to as “X.Y” -- for example version 5.2.x to refer to versions 5.2, 5.2.1, and all other versions in the 5.2. (five dot two dot) branch of that software. Major Releases often are the introduction of new major features and functionality.

RevisionsRevisions The WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. to the theme accessibility guidelines

WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Europe Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/.

Updates from working groups

  • Design
  • Documentation
  • General
  • GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/
  • Media
  • MetaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress.
  • Themes

Open floor

If you want to have a topic added to the agenda, please mention it in the comments of this post.

The Accessibility Team bug scrub has moved to Tuesdays, 16:00 UTC.

This meeting is held in the #accessibility channel in the Making WordPress SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. (requires registration).

#accessibility, #agenda

Accessibility Team Meeting Agenda: April 02, 2025

This is the proposed agenda for the weekly AccessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) Team meeting on Wednesday, April 02, 2025, 15:00 UTC.

Accessibility Improvements in WordPress 6.8

Accessibility Improvements planning for the next major releaseMajor Release A set of releases or versions having the same major version number may be collectively referred to as “X.Y” -- for example version 5.2.x to refer to versions 5.2, 5.2.1, and all other versions in the 5.2. (five dot two dot) branch of that software. Major Releases often are the introduction of new major features and functionality.

RevisionsRevisions The WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. to the theme accessibility guidelines

Updates from working groups

  • Design
  • Documentation
  • General
  • GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/
  • Media
  • MetaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress.
  • Themes

Open floor

If you want to have a topic added to the agenda, please mention it in the comments of this post.

The Accessibility Team bug scrub has moved to Tuesdays, 16:00 UTC.

This meeting is held in the #accessibility channel in the Making WordPress SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. (requires registration).

#accessibility, #agenda

X-post: Help Test WordPress 6.8

X-comment from +make.wordpress.org/test: Comment on Help Test WordPress 6.8