New contributions are welcomed. Follow this guide if you want to make one.
Follow Github guide to fork a repo and create a pull request.
Generally, bug fixes should go to the stable
branch
and new features should go to master
.
Commit messages should describe what have been changed and why. The first line should be wrapped to 50 characters, the second one should be blank. All other lines should be wrapped to 72 characters.
Example of a good commit message.
Before submitting pull request, make sure your code passes all code style and static analysis checks. To do so, run:
npm run lint
Some functional tests are launched on SauceLabs. In order to run them you'll need to:
- Register open source SauceLans account.
- Set your username and key to
SAUCE_USERNAME
andSAUCE_ACCESS_KEY
environment variables respectively.
Make sure all tests are passing before submitting pull request:
npm test
If you are fixing the bug, add a test that fails without your patch and passes with it. If you are adding a feature, write a test for it. To see test coverage report run:
npm test --coverage