WordPress / contributor-handbook

Draft for the WordPress.org Contributor Handbook
https://make.wordpress.org/handbook/
GNU General Public License v3.0
7 stars 3 forks source link

Feedback on new desired handbook structure #14

Open CoachBirgit opened 2 months ago

CoachBirgit commented 2 months ago

Objective

The DEIB working group committed to update and expand the current Contributor Handbook. We need your feedback and suggestions about the desired structure of the overhauled handbook.

Feedback required

Please leave your feedback below as a comment or in the Google Doc with commenting permissions

Notes

patriciabt commented 1 month ago

I would suggest to include chapters such as:

And of course what Josepha mentioned in the initial proposal:

angelasjin commented 1 month ago

As we move forward with this, I took a peek at some other handbooks we have across the WordPress ecosystem, and began to wonder the purpose of this particular handbook. My sense is that the people we want to direct to this handbook are:

I'm curious what you all think about that :)

If my sense is on the right track, I think it would change how we structure the handbook and what information we would include. My general recommendation is that we keep this handbook as lean as possible so that it avoids being overwhelming to new contributors, makes it easy to search for information, and is a handy guide to direct folks to various parts of the project.