Contributing

Releasing

Changelog, and releasing is autmated with npm scripts. To create a release:

Ensure a clean working git workspace.
Run npm version {patch,minor,major}.
- This wills update the version number and generate the changelog.
Run npm publish.
- This will push your local git branch and tags to the default remote, perform a gh-release, and create an npm publication.

Patches, ideas and changes welcome.
Fixes almost always welcome.
Features sometimes welcome.
- Please open an issue to discuss the issue prior to spending lots of time on the problem.
- It may be rejected.
- If you don't want to wait around for the discussion to commence, and you really want to jump into the implementation work, be prepared for fork if the idea is respectfully declined.
Try to stay within the style of the existing code.
All tests must pass.
Additional features or code paths must be tested.
Aim for 100% coverage.
Questions are welcome, however unless there is a official support contract established between the maintainers and the requester, support is not guaranteed.
Contributors reserve the right to walk away from this project at any moment with or without notice.