Repository navigation
Update Handbook : "Handbook" #3447
Description
Details
- URL: https://make.wordpress.org/training/handbook/
- Content title: Handbook
- Topic description: This handbook page is currently very short and does not provide much useful information for users. We can either consider removing the page or expanding it with additional guidance and resources. It would be helpful to gather feedback from others to decide the best direction, and if needed, we can update and improve the content accordingly.
Current Content:
Welcome to the WordPress.org Training Team’s handbook! We hope you’ll find the information here helpful. Please check out the information here and visit us in the #training channel in Slack.
Activity
huzaifaalmesbah commentedon May 20, 2026
I'd love to help expand this page! I'll work on a draft and share it here for review soon.
huzaifaalmesbah commentedon May 24, 2026
I’ve created a draft for the updated handbook page and would really appreciate your review and feedback.
Draft link: https://docs.google.com/document/d/1eMZVI3F5BerwU09KzZ8uonbZCIT1C-syCfN6sF3StN4/edit?usp=sharing
Please let me know if any sections need improvement, modification, or additional content. I’d especially appreciate suggestions on:
Looking forward to your feedback. Thank you!
icirkovic commentedon Jun 16, 2026
@huzaifaalmesbah I've gone through the doc and made a few suggestions, overall, good work!
miyanialkesh7 commentedon Jun 30, 2026
@huzaifaalmesbah I have added new comments in the doc file. Most of the items are small editorial improvements and consistency fixes.
sumitsinghwp commentedon Jul 6, 2026
i have checked and i think look good for now.
@devmuhib009 @rjekic check and let me know please?
rjekic commentedon Jul 7, 2026
I left my set of comments. I agree with most of the comments left there, we should approve them and update the page.
cc @sumitsinghwp @devmuhib009
sumitsinghwp commentedon Jul 15, 2026
Great, let's plan who can do these things :)
JAIR187 commentedon Nov 9, 2026
Hello everyone.
I've read the draft in the Google Doc and the existing comments from other contributors.
I'd like to offer some feedback from the perspective of someone who is just starting to contribute to this team:
For a newcomer, the "How to get started" section is the most important part. The restructuring proposed by others makes sense, but I think it could be improved by providing more detail for the reader. Adding a prominent call-to-action—something like "Start here: [link to the 'How to get started' page]"—would help those who arrive on this page and aren't sure what their next step should be.
I also noticed that the current draft is quite text-heavy. I suggest incorporating other presentation methods—such as a video, a simple table, or a bulleted list of "Ways to contribute"—with links to the respective onboarding paths (Content Creator, Editor, etc.). This would allow people to orient themselves quickly without reading through long paragraphs, and would also help people who prefer visual or scannable content.
I think the content is nearly ready. I'm also happy to review the updated page once it's live.
Thank you!