Please remember to review content constructively and kindly. The emphasis is not on perfection but rather on community, contribution and iteration.
If you’re reviewing non-English content, please follow this guide instead: Reviewing Translations
Suggestions for how to review tutorials/lessons and provide actionable feedback
- Are the learning outcomes or achievement objectives clear?
- Check for technical accuracy, i.e. has the person described or misdescribed something or used any technical terms incorrectly. Suggest ways of explaining things better or more clearly.
- Is the speed of demonstrations appropriate to follow along and understand?
- Does the narration match the slides and demonstration?
- Are grammar and spelling correct? (Note, the Training Team uses American English for its English resources. See Language and Spelling for more information about this.)
- Is sound quality consistent throughout the video?
- Are the Brand Usage Guidelines and Promotional Guidelines being followed?
- Are any media assets used CC0?
Suggestions for how to review courses and provide actionable feedback
- Are the learning outcomes or achievement objectives clear?
- Check for technical accuracy, i.e. has the person described or misdescribed something or used any technical terms incorrectly? Suggest ways of explaining things better or more clearly.
- Are the steps clear and accessible for anyone to follow, including ESL (English as a Second Language) and neurodivergent readers?
- Does the layering of information successfully build from lesson to lesson?
- Is it easy to skim-read the content?
- Are grammar and spelling correct? (Note, the Training Team uses American English for its English resources. See Language and Spelling for more information about this.)
- Could we improve the activities and assessments in the course?
- Do lessons contain enough relevant links to documentation (WordPress documentation or any other relevant documentation)?
- Do all the links work?
Also, if there are parts of the content you particularly liked, feel free to leave comments about those on the 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/ issue, too!
Are you reviewing content before it is published?
If so, then please leave your review comments on the GitHub issue tracking the creation of that piece of content. You can do this by following these steps:
- Find the GitHub issue for the content you are reviewing. (You can find a list of content needing feedback from this link.)
- Copy-paste the appropriate checklist from below as a new comment on the GitHub issue. (There are different checklists for different types of content.)
For Tutorials and Learning Pathway Lessons
## Tutorial/Lessons Review Checklist
Please tick all items you've confirmed:
- [ ] Learning outcomes/objectives are clear.
- [ ] Technical concepts introduced in the content are accurate.
- [ ] The speed of demonstrations are easy to follow.
- [ ] The narration audio matches what is shown visually.
- [ ] Spelling and grammar are correct.
- [ ] Sound quality is consistent throughout the video.
- [ ] [Brand Usage Guidelines](https://make.wordpress.org/training/handbook/guidelines/brand-usage-guidelines/) and [Promotional Guidelines](https://make.wordpress.org/training/handbook/guidelines/promotional-guidelines/) are being followed.
- [ ] Media assets are all in the public domain ([CC0](https://creativecommons.org/share-your-work/public-domain/cc0/)).
Leave an additional comment below with feedback. You can also share what you liked about this Tutorial.
For Courses
## Course Review Checklist
Please tick all items you've confirmed:
- [ ] Learning outcomes/objectives are clear.
- [ ] Technical concepts introduced in the content are accurate.
- [ ] Steps are easy to follow.
- [ ] Each lesson successfully builds on top of each other.
- [ ] Content is easy to skim-read.
- [ ] Spelling and grammar are correct.
- [ ] Activities/assessments are appropriate.
- [ ] Lessons contain enough links to relevant resources.
- [ ] [Brand Usage Guidelines](https://make.wordpress.org/training/handbook/guidelines/brand-usage-guidelines/) and [Promotional Guidelines](https://make.wordpress.org/training/handbook/guidelines/promotional-guidelines/) are being followed.
Leave an additional comment below with feedback. You can also share what you liked about this Course.
- Once the comment has been published, you’ll notice it has turned into a checklist. Go through and check off items as you review the comment.
- Leave an additional comment on the GitHub issue with any additional feedback you have.
- And you’re done! Thank you for contributing to the Training Team.
Leaving feedback in GitHub helps the Training Team track your contributions. It also helps others see what comments have already been made so that their efforts donāt double up with what has already been done.
Are you reviewing content after it is published?
If so, then please leave your review as a new Content Feedback issue on GitHub. This tracks your contribution to the team, and also leaves a public note about your feedback so that anybody can come and make updates as needed. You can submit a new report by following these steps:
- Find a piece of content to review from https://learn.wordpress.org
- Then, go to the list of issue templates on the Training Team’s GitHub repo
- Find
Content Feedback
and clickGet Started
- Follow the directions you’ll see in the issue template to update the issue title and description
- That’s it!