HelpHub is going to be the new portal for all WordPress user documentation that currently resides on the WordPress Codex. This repo is where we will be managing development of this new portal.
You can get involved in development (or any other aspect of the project) by attending our weekly meetings in the #docs channel of the Making WordPress Slack every Tuesday at 14:00 UTC.
To use this repo, simply create a new WordPress site on your local machine (using whatever development environment suits you), then empty out the wp-content folder and clone this repo into it. You will also need to add the following line to your site's wp-config.php file:
define( 'WPORGPATH', 'https://wordpress.org/' );
Anyone is welcome to fork the repo and send pull requests, but the project collaborators (listed below) have push access directly to the repo. All pull requests will be be reviewed by at least one collaborator with commit access and the PR must pass tests. Collaborators will be responsible for merging their own pull requests once the reviews has been approved. Major feature development will require a review from the project lead, minor ones do not.
We use ZenHub for project management, see WordPress#79 for help on using it
All features are to be built in individual branches named feature-abc (where abc is a brief descriptor of the feature) and submitted via pull request to the master branch. For best results, features should be separated into their own plugins, but the project lead will evaluate this for each pull request depending on the requirements and scope of the feature.
Any fixes that do not qualify as new features are to done in individual branches named fix-abc (where abc is a brief descriptor of the fix) and submitted via pull request to the master branch.
As this is a WordPress community project, all development must have a strong committment to accessibility and responsive design. We will also be following the WordPress coding standards throughout the project.
Given that we will ultimately need to localise the whole site for different languages, please use helphub as the text domain for all text strings.
A database export is available here - https://github.com/Kenshino/HelpHub/blob/master/helphub.wordpress.2017-06-15.xml
See the HelpHub wireframes for a guide on the design and layout of the project and note that all design must be consistent with the rest of WordPress.org.
Project Lead: Jon Ang
The following people are active developers on the project and are all listed as collaborators on this repo:
| Name | GitHub username | Slack username |
|---|---|---|
| Hugh Lashbrooke | hlashbrooke | hlashbrooke |
| Sara Cope | saracope | sarassassin |
| Justin Greer | justingreerbbi | justingreerbbi |
| Nicole Arnold | NicoleA | nlarnold1 |
| Jon Ang | kenshino | kenshino |
| Stephanie Green | greensteph | greensteph |
| Jonathan Bossenger | jonathanbossenger | jon_bossenger |
| Jay Hoffmann | JasonHoffmann | jayhoffmann |
| Carl Alberto | carl-alberto | carlalberto |
| Marius Jensen | clorith | clorith |
| Jude Rosario | JudeRosario | lumberhack |
| Stephen Edgar | ntwb | netweb |