CONTRIBUTING.md

Contributing

Workflow

A good workflow is to work directly in this repo, branch off master, and submit your changes as a pull request.

Ideally name your branches with prefixes and descriptions, like this: [type]/[change]. A good prefix would be:

• add/ = add a new feature
• try/ = experimental feature, "tentatively add"
• update/ = update an existing feature

For example, add/foo-module means you're working on adding a new foo module.

You can pick among all the issues, or some of the ones labelled Good First Issue.

Developing

Be sure to have Node.js installed first. You should be running a Node.js version matching the current active LTS release or newer. You can check this with node -v.

Make sure that npm is installed with version >= 5.0.0 using npm -v.

Setup

$ git clone https://github.com/WordPress/packages.git
$ cd packages
$ npm install

Testing

In order to run the tests:

$ npm test

# If you want to watch for changes
$ npm run test:watch

# If you want to check code coverage
$ npm run test:coverage

Releasing

This repository uses lerna to manage and release the packages. Lerna automatically releases all the outdated packages. To check which packages are outdated and will be released, type npx lerna updated.

Development release

Run the following command to release a dev version of the outdated packages:

npm run publish:dev

Lerna will ask you which version number you want to choose for each package. For a dev release, you'll more likely want to choose the "prerelease" option. Repeat the same for all the outdated packages and confirm your version updates.

Lerna will then publish to npm, commit the package.json changes and create the git tags.

Production release

To release a production version for the outdated packages, run the following command

npm run publish:prod

Choose the correct version (minor, major or patch) and confirm your choices and let Lerna do its magic.