Title: Review a Pathway Guide
Author: WordPress.org
Published: April 2, 2026
Last modified: June 11, 2026

---

# Review a Pathway Guide

## In this article

 * [Steps](https://make.wordpress.org/handbook/pathways/test/review-a-pathway-guide/?output_format=md#steps)
 * [Contribution checklist](https://make.wordpress.org/handbook/pathways/test/review-a-pathway-guide/?output_format=md#contribution-checklist)
 * [What happens next](https://make.wordpress.org/handbook/pathways/test/review-a-pathway-guide/?output_format=md#what-happens-next)
 * [Help](https://make.wordpress.org/handbook/pathways/test/review-a-pathway-guide/?output_format=md#help)

[↑ Back to top](https://make.wordpress.org/handbook/pathways/test/review-a-pathway-guide/?output_format=md#wp--skip-link--target)

Help keep pathways accurate and newcomer-friendly by actually completing the contribution
a guide describes. Follow every step as a first-timer would, note where you get 
stuck or confused, flag broken links, and file an issue with what you find.

 * **Reference:** [About Pathways](https://make.wordpress.org/handbook/pathways/about/)—
   purpose and principles of contribution pathways
 * **Connect:** Join [#core-program](https://wordpress.slack.com/archives/core-program)
   and introduce yourself, saying you’ll be reviewing pathways

## 󠀁[Steps](https://make.wordpress.org/handbook/pathways/test/review-a-pathway-guide/?output_format=md#steps)󠁿

 1. **Pick a pathway to review.** Choose from [Walkthrough Requests](https://github.com/orgs/WordPress/projects/282/views/6)
    and add a comment to indicate you’re working on it. If you type `/assign` as your
    comment, our workflows will assign the issue to you.
 2. **Complete its contribution as a newcomer.** Follow every step from the top as 
    if it’s your first contribution. Don’t skip anything: click the links, run the 
    setup, and most importantly, try completing that contribution.
 3. **Check all links.** Verify that every link works and points to the right place.
 4. **Note any unclear sections.** If instructions are confusing, steps are missing,
    or the tone feels off, mark it. The goal is to spot what trips up a first-timer.
 5. **File an issue with your findings.** Report what worked and what didn’t. Be specific:“
    Step 3 assumes I already have X installed” or “The link in step 2 is broken.” If
    you discover a related bug, mention it and link to any context you’ve found. Include
    suggested rewording if you have it — paste the original text along with your version.
 6. **Signal it’s done.** Comment with your findings. If you’ve completed the contribution
    successfully, add another comment with just `/done` in it, and we’ll close the 
    issue.

## 󠀁[Contribution checklist](https://make.wordpress.org/handbook/pathways/test/review-a-pathway-guide/?output_format=md#contribution-checklist)󠁿

 * Completed the contribution, following every step of the guide
 * Verified all links work and point to the correct resources
 * Commented with your findings
 * Filed an issue with specific, actionable feedback if needed

## 󠀁[What happens next](https://make.wordpress.org/handbook/pathways/test/review-a-pathway-guide/?output_format=md#what-happens-next)󠁿

If you’ve shared feedback, the pathway author or a maintainer will review it. If
there’s no response after a week, a polite pingPing The act of sending a very small
amount of data to an end point. Ping is used in computer science to illicit a response
from a target server to test it’s connection. Ping is also a term used by Slack 
users to @ someone or send them a direct message (DM). Users might say something
along the lines of “Ping me when the meeting starts.” in the relevant team’s SlackSlack
Slack is a Collaborative Group Chat Platform [https://slack.com/](https://slack.com/).
The WordPress community has its own Slack Channel at [https://make.wordpress.org/chat/](https://make.wordpress.org/chat/)
is fine.

When you’re ready, review another pathway or try [creating one](https://make.wordpress.org/handbook/pathways/write/create-a-pathway-guide/).

## 󠀁[Help](https://make.wordpress.org/handbook/pathways/test/review-a-pathway-guide/?output_format=md#help)󠁿

Stuck? Check the [getting help guide](https://make.wordpress.org/handbook/pathways/before-you-begin/#getting-help),
then ask in the relevant team’s Slack channel (the pathway should list which team
owns it).

**Further reading:**
 – [TEMPLATE.md](https://github.com/WordPress/contributor-handbook/blob/main/pathways/TEMPLATE.md)—
pathway structure and guidelines

  Test

 Beginner-friendly project

New here? [Get set up](https://make.wordpress.org/handbook/pathways/before-you-begin/)
with accounts, community basics, and info on badges.

First published

April 2, 2026

Last updated

June 11, 2026

Edit article

[ Improve it on GitHub: [article_title] ](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fhandbook%2Fpathways%2Ftest%2Freview-a-pathway-guide%2F&locale=en_US)

Changelog

[ See list of changes: [article_title] ](https://make.wordpress.org/handbook/pathways/test/review-a-pathway-guide/?output_format=md#)

[  Previous: Test](https://make.wordpress.org/handbook/pathways/test/)

[  Next: Test for Accessibility](https://make.wordpress.org/handbook/pathways/test/test-for-accessibility/)