New contributor at a Contributor Day

  • Weekly Office Hours: Mondays 15:00 UTC
  • Where: The #docs channel on Slack

This guide is a quick starting point for first-time contributors for the Documentation Team. If you are on a Contributor Day at a local WordCamp, this should get you pointed in the right direction. If you feel there is any aspect left out of this please let us know in the comments below.

Getting started Getting started

If you haven’t got a account already, now would be the time to create one. You can easily create one using the registration form on the website. Once you’re done with that it’s time to get on Slack. Slack is used by the Documentation team to coordinate efforts and to keepin touch. You can sign up on the webversion of the Slack. Use your credentials to create an account and head to the #docs channel. There you should find people that can help you with any questions you might have regarding the documentation process.

Top ↑

Open projects Open projects

Currently there are two projects that can use your help. These two are the current main focus for the Documentation Team. The projects are HelpHub and the inline documentation for all JavaScript used in WordPress.

HelpHub HelpHub

You can find the current state of this project listed in an earlier post on our pages. If you do decide to help out with HelpHub, make sure you read up on our styling and formatting guide.

Top ↑

Inline JavaScript documentation Inline JavaScript documentation

The second project that’s currently being worked on is the inline documentation for all JavaScript used in WordPress. You should be able to find all information relevant to that in this (Core) post.

Top ↑

Other projects Other projects

If these two projects are not your cup of tea: Take a look at our Current Projects page. You can find more documentation projects there. While these currently don’t have our main focus they can still use some love and care.

Top ↑

Working on HelpHub Working on HelpHub

If you want to help out with HelpHub, you’re going to need access to the staging environment. You can request access from anyone that has administrative rights within the HelpHub Staging Environment. Most of them are in the #docs channel on Slack. If you request access in that channel you should get an answer in there rather quickly.

Most work is currently coordinated in this Google document. Most of the work being done right now is proofreading all articles that are currently in HelpHub.

Top ↑

Prior Knowledge Prior Knowledge

Prior knowledge that you’ll find helpful for working on docs is:

  • some familiarity with WordPress, though keep in mind that writing docs is an excellent way to learn
  • good English language skills
  • knowledge of theme development for working on the Theme Developer handbook
  • knowledge of plugin development for working on the Plugin Developer handbook
  • for writing documentation, the ability to write clear, concise documentation
  • development skills (PHP, CSS) if interested in building tools