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.
- Reference: About Pathways
- Connect: Join #core-program and introduce yourself
Steps
- Familiarize yourself with the project. Review the Contributor Handbook GitHub repository and the pathway project board.
-
Pick up an issue. Choose one from Ready or New on the project board, comment
/assignto show that you’re working on it, then 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. Use PROMPT.md and AI, or TEMPLATE.md as your guide. Post your draft (with markdown) as a comment on the issue.
-
Walk the pathway using your draft as a new contributor would. Ask teams for feedback, too, and refine the markdown you’ve shared based on what you learn.
-
Signal it’s reviewed and ready by commenting
/doneon the issue. If you’re able, set its Projects > Status to Update Manifest. Then add an .md file to the correct directory and submit a pull request, or an admin can add one from your comment.
Contribution checklist
- All links work and are current
- Draft is scannable and fits the TEMPLATE.md structure
- Pathway tested, feedback requested, and refined accordingly
- PR submitted referencing the issue, or guide shared as markdown in a comment
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. You can also suggest new guides.
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
