WordPress Project Contributor Handbook v2

In March 2021, Josepha introduced the proposal of a WordPress Project Contributor Handbook. This handbook was intended to be an overarching resource and place for policies, best practices, guides and other foundational content related to open-source and the global WordPress project.

Imagine it as a comprehensive map that will guide every contributor through our beloved WordPress landscape.

As the founder and spearhead of the DEIB (Diversity, Equity, Inclusion, and Belonging) working group, I’m excited to update you on an exciting development: we’ve committed ourselves to a revamp of the Contributor Handbook into the next iteration. This handbook – like every other handbook – is a living document and needs to grow alongside the project and its community. 

The Value of a Unified Guide

The new Contributor Handbook aims to be the quintessential resource for everyone in our community. It will provide a bird’s-eye view of where to find key information and how different aspects of our community interconnect. From community engagement rules to technical guidelines, this handbook will cover it all, making your journey as a WordPress contributor clearer and more structured.


The Contributor Handbook currently includes pages 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), Privacy Policy, a DEI Statement, the Community Code of Conduct, and Incident Response Team. Pages or parts of documentation that require legal consideration, like the Privacy Policy, will not be included in the scope of this work. Wherever required, the intention is to collaborate with teams that are most familiar with the page, for example, the Community Code of Conduct with the Incident Response Team. 

Collaboration Across Teams

Enhancing the handbook is a collaborative effort involving several key teams:

  • Community Team: Focusing on integrating community interaction norms and event guidelines.
  • Documentation Team: Ensuring that the handbook is comprehensive and easy to navigate.
  • Project Leadership: Offering strategic guidance to align the handbook with broader WordPress objectives.

This cross-team collaboration ensures that the handbook serves as a holistic guide to the WordPress ecosystem, tailored to meet the needs of all contributors, new and seasoned alike.

Progress and Acknowledgments

Thank you to @chanthaboune and @angelasjin for the first iteration of the Contributor Handbook, and for suggestions provided by @jeffpaul, @tobifjellner, @dd32, @juliacanzani, @poena, @sereedmedia, @joedolson, @ryelle

Also thanks to @milana_cap, @j9magayanes, @TantienHime, and @CoachBirgit for their foundational work moving the needle forward at the CloudFest Hackathon. Their efforts led to the creation of a 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/ repository, which is now officially part of the WordPress organization, thanks to @dd32 and @leogopal. This repository is the new home for our ongoing development and collaboration on the handbook.

Call to Action: We Need Your Voice!

Your involvement is crucial as we refine and enhance the handbook:

  • Review and Feedback: Dive into the Contributor Handbook GitHub repository to explore the drafts and contribute your suggestions.
  • Join the Discussion: Comment below to discuss how the handbook can better serve as your go-to resource.


Our goal is to not just create a handbook, but to foster a living document that evolves with our community. Your involvement will help mold it into a dynamic resource that reflects the needs and knowledge of all WordPress contributors. Together, let’s build a resource that not only guides, but also inspires and unites us in our shared mission.

Next Steps

We’re committed to making the Contributor Handbook a fundamental tool for everyone in our community. Let’s work together to create a resource that not only informs, but also empowers.

Props to @angelasjin for reviewing and contributing to this announcement post

#DEIB #DEI #discussion #handbook #WPDiversity

X-post: Recognizing Contributions and Acknowledging Challenges

X-comment from +make.wordpress.org/sustainability: Comment on Recognizing Contributions and Acknowledging Challenges

Let’s try out online DEIB course content!

The WordPress community has long advocated for diversity, equity, inclusion, and belonging (DEIB) training. Over the years, teams have explored various avenues, usually engaging diversity consultants. While this has been a valuable experience, extending such training to our vast and diverse community has been challenging, given our global community and the many timezones we cover. 

Today, I am excited to share that Automattic has added 100 licenses to their Paradigm Reach account for WordPress community members. While this isn’t a full solution, I am optimistic that it is a step in the right direction. Paradigm Reach offers a comprehensive suite of online coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. workshops, microlearnings, and resources created by professional experts from around the world. Their platform allows for customization of learning content for users. 

Some recognized limitations and future hopes

In reviewing Paradigm Reach, there are a few limitations I’d like to note. Firstly, only 100 licenses are available. However, the licenses can be reassigned, meaning that when a contributor completes assigned courses, their access can be removed and granted to another contributor. Second, because the usual audience for Paradigm Reach tends to be businesses and employers, some of the examples used are in a more corporate or work setting. However, the content itself is still valuable and principles can be applied to collaboration and engagement in the WordPress community. Lastly, the content is in English, and there are no translations of the material. 

While these limitations are very real, I still believe there is a net positive in introducing Paradigm Reach and that it will help the WordPress community get to a more conscientious and equitable future state. My hope is that through this initial online training, enough community members around the world are able to participate in high quality and consistent DEIB training, and begin to build shared language and understanding around DEIB. Then, a working group of members who have participated in this training can leverage what they have learned to create online DEIB training specifically for the WordPress contributor community, which can be translated and made available at any time, to any one. 

Some more immediate next steps

For starters, it makes sense to try out two courses, an “Intro to DEIB” and an “Advanced DEIB” course. Because the licenses are limited, I’d like to invite the following contributor groups to try out this async training:

  • Contributors who mentor or guide other contributors, like mentors for the Contributor Mentorship Program
  • Contributors who handle sensitive mediation work, like Incident Response Team (IRT) Members (all IRT members are required to complete DEIB training)
  • Contributors who communicate with large, international audiences, like Flagship event organizers
  • Contributors who want to provide DEIB training to others, like DEIB working group leaders
  • Contributors who have never experienced DEIB training previously

While the content should take no more than 3 hours to complete, participants will be given 8 weeks to finish assigned courses. Participants will also be asked to provide feedback on the content and recommendations for improvement. 
If you are interested in taking online DEIB training through Paradigm Reach, please fill out this form. Have questions or comments? Leave those in the comments below!