timestring/CONTRIBUTING.md
2015-05-05 11:17:00 +01:00

1.5 KiB

#Contributing

Contributions are welcome and will be fully credited.

Contributions can be made via a Pull Request on Github.

##Pull Requests

  • jQuery coding style - JSCS. Make sure you run gulp sa before commiting your code.

  • Add tests where appropriate - Mocha, Chai

  • Document any change in behaviour - Make sure the README and any other relevant documentation are kept up-to-date.

  • Create topic branches - i.e feature/some-awesome-feature.

  • One pull request per feature

  • Send coherent history - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before submitting.

##Building The Project

Gulp is used to build the project. The project uses ES6 so it needs to be transpiled. Once transpiled the code is then browserified. You can build the project by running:

gulp build

This will perform all build steps, including running the tests and static analysis tools.

##Running Tests

Once the project has been built, the tests can be run with:

gulp test

Alternatively, to build and test at the same time you can run:

gulp ci

This will transpile, browserify and run the tests and static analysis tools.