Make WordPress – Contributor Handbook

This repo is dedicated to the overarching Make WordPress Contributor Handbook which is located at https://make.wordpress.org/handbook/

Initially proposed in March 2021 by Exexutive Director of the WordPress project Josepha Hayden-Chomphosy. During the CloudFest Hackathon March 2024 members of the global WordPress DEIB working group commited to update and expand the initial content.

Objective

The objective of this Contributor Handbook is to provide guidance and resources for individuals who wish to contribute to our beloved open-source project.

This handbook aims to give easy access to foundational content and a birds-eye view of the global WordPress project.

Get Involved

For discussion, questions and meetings, please join the WordPress #DEIB-working-group Slack channel. Join the text-based Meetings every other week on Friday at 1pm UTC.

Roadmap

• [x] Phase 0: Create an initial structure to understand the categorization.
• [x] Phase 1: Create the empty-files with a link inside, so there is all the structure.
• [ ] Phase 2: Add the content (only copying from the original page and create the content structure).
• [ ] Phase 3: Publish a first updated version of the Contributor Handbook.
• [ ] Phase 4: Check and improve the content.

File Structure

Based on Contributor Handbook

GitHub Repo structure

• README
• LICENSE
• Code of conduct
• CONTRIBUTE

Handbook pages

• Contributor Handbook
  • Community Code of Conduct
  • Privacy Policy
  • Accessibility in WordPress
  • Diversity, Equity, Inclusion and Belonging (DEIB) Statement
  • Incident Response Team

Contributor Handbook managers

This handbook is managed by @angelasjin and @coachbirgit. Also the Documentation Team and Community Team are involved in this.

Recommendations

Style guide

• WordPress Documentation Style Guide
  • General guidelines
  • Language and grammar
  • Punctuation
  • Formatting
  • Linking
  • Developer content

External linking

• External Linking Policy (Summary)

Changelog README.md

• March 16, 2024: initial commit during CloudFest Hackathon under OS DEIB Org on GitHub
• April 18, 2024: transfer of the repo to the WordPress org on GitHub
• May 8, 2024: replacing content with project relevant objective