The WordPress user documentation portal
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github WXR Export (#155) Feb 18, 2018
bin Add PHPUnit testing framework (#68) Dec 22, 2016
plugins PArtial revert of overzealos 59c70c6 commit Nov 7, 2018
staging-database Latest staging database. Aug 22, 2018
tests Update project files with wporg files (#154) Feb 21, 2018
themes Merge `wporg-support` updates back to HelpHub Nov 8, 2018
.editorconfig Update `.editorconfig` (#269) Oct 29, 2018
.gitignore Cleanup select2 assets, follow up to #271 Nov 7, 2018
.jscsrc Tools: Initial pass adding Grunt tasks for JSHint, JSCS, JSValidate, … Dec 22, 2016
.jshintignore Tools: Initial pass adding Grunt tasks for JSHint, JSCS, JSValidate, … Dec 22, 2016
.jshintrc Tools: Initial pass adding Grunt tasks for JSHint, JSCS, JSValidate, … Dec 22, 2016
.npmrc Update `.npmrc` to save packages using `~` by default Oct 30, 2018
.nvmrc Bump Node.js minimum to LTS 8.x Oct 30, 2018
.stylelintrc Update 'root' stylelint config Nov 7, 2018
.travis.yml Remove PHP 7.0 & 7.1 from Travis CI Oct 30, 2018
CONTRIBUTING.md Latest database from staging site, updated CONTRIBUTING file. Mar 13, 2018
Gruntfile.js Cleanup select2 assets, follow up to #271 Nov 7, 2018
README.md Typo fix in README.md (#244) Jul 6, 2018
composer.json Fix PHPCS Errors (#265) Oct 30, 2018
composer.lock Fix PHPCS Errors (#265) Oct 30, 2018
package.json Update packages to the latest versions Oct 30, 2018
phpcs.ruleset.xml Fix PHPCS Errors (#265) Oct 30, 2018
phpunit.xml.dist Add PHPUnit testing framework (#68) Dec 22, 2016

README.md

HelpHub

Build Status

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.

Get Involved

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 Monday at 15:00 UTC.

How to use this repo

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 can get more information about running the HelpHub code base locally via reading the contributing document

Workflow

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 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 https://github.com/Kenshino/HelpHub/issues/79 for help on using it

Feature development

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.

Bug fixes

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.

Development guidelines

As this is a WordPress community project, all development must have a strong commitment 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 wporg-forums 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

Design guidelines

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 collaborators

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
Jon Ang @kenshino kenshino
Carl Alberto @carl-alberto carlalberto
Marius Jensen @clorith clorith
Jude Rosario @JudeRosario lumberhack
Milana Cap @zzap zzap
Akira Tachibana @atachibana atachibana
Stephen Edgar @ntwb netweb
Mark Uraine @mapk mapk