Skip to content

Latest commit

 

History

History
55 lines (39 loc) · 3.19 KB

CONTRIBUTING.md

File metadata and controls

55 lines (39 loc) · 3.19 KB

Contributing

How to contribute code

1. Decide what to work on

Then, tell folks what you'll be working on, and:

2. FORK this repo

Everyone must follow the rules below (inspired by the C4.1 process) to submit code (documentation may be edited directly by maintainers):

  1. Always work in your own fork and submit pull requests (PRs) to master.
  2. Always submit a minimal and accurate answer to any issue. The simplest solution is the best solution.
  3. Always add/update tests for any new/modified functionality. (:exclamation:)
  4. Always make sure your PR passes all tests (grunt test).
  5. Always ensure your PR adheres to the Contribution Policy described below.

3. Follow this Contribution Policy

This contribution policy will evolve over time. For now it is based on a mixture of the Mileposts Methodology and a slightly modified subset of C4.1.

Licensing and Ownership

  1. All contributions to the project source code ("patches" or "pull requests") SHALL use the same license as the project.
  2. All patches are owned by their authors. There SHALL NOT be any copyright assignment process.
  3. Each Contributor SHALL be responsible for identifying themselves in the project Contributor list.

Pull Request Requirements (:exclamation:)

  1. A PR SHOULD be a minimal and accurate answer to exactly one identified and agreed problem.
  2. A PR SHALL NOT include non-trivial code from other projects unless the Contributor is the original author of that code.
  3. A PR MUST pass all tests on at least the principle target platform.
  4. A PR MUST include new tests for any new functionality introduced.
  5. A PR SHOULD avoid "callback-hell" style and instead prefer "async/await" style.
  6. A PR MUST follow the requirements spelled out in this project's Style Guide.

How to submit an issue