Function: Write
Type: Project
Level: Beginner
Turn a pathway idea into a finished guide. Pick up an issue from the project board, draft it, get feedback, and submit a pull request to get published.
Before you start
Complete the common setup first, then:
- Setup: Familiarize yourself with the Contributor Handbook GitHub repository and the pathway project board
- Read: Review About Pathways
- Connect: Join #core-program and introduce yourself
Steps
- Pick up an issue from Ready or New on the project board, comment that you’re working on it, and research the topic using linked resources, handbooks, tutorials, Learn WordPress, WordPress.tv, and team 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/ channels.
- Draft the guide using PROMPT.md and AI, or with TEMPLATE.md as your guide, then post your draft as a comment on the issue.
- Walk the pathway using your draft as a new contributor would. Ask teams for feedback, too, and refine based on what you learn.
- Submit a pull request to the folder matching the pathway’s function — for example, if you wrote a test pathway, submit to pathways/test/. Reference the issue in your PR description.
Contribution checklist
- All links work and are current
- Your draft is scannable and fits the TEMPLATE.md
- You’ve tested the pathway, requested feedback, and refined accordingly
- You’ve submitted a PR referencing the issue
What happens next
Maintainers will review your PR for clarity, accuracy, and completeness. Once approved, the pathway will be merged and published to the handbook.
When you’re ready, pick up another pathway from the project board or help review someone else’s draft.
Help
Stuck? Check the getting help guide, then ask in #core-program.
Further reading:
- TEMPLATE.md — pathway structure and format
- PROMPT.md — detailed writing guide for each section
- WordPress Brand Writing Style Guide — tone and terminology
