Skip to content

Contribution Guide ​

litmus is a fully open-source project, which is developing by the community for the community. We welcome contributions of any kind, including but not limited to:

  • Bug reports
  • Feature requests
  • Code contributions
  • Documentation improvements
  • Discussions

Community Guidelines ​

This project follows Google's Open Source Community Guidelines. In short: all contributors are treated with respect and fairness.

Contributor License Agreement ​

Contributions to this project must be accompanied by a Contributor License Agreement. You (or your employer) retain the copyright to your contribution; this simply gives us permission to use and redistribute your contributions as part of the project. Head over to https://cla.developers.google.com/ to see your current agreements on file or to sign a new one.

You generally only need to submit a CLA once, so if you've already submitted one (even if it was for a different project), you probably don't need to do it again.

How to Contribute ​

Before proposing changes, look for similar ones in the project's issues and pull requests.

When ready to move on:

  • Prepare your development environment.
    • Ensure you have all dependancies installed.
  • Fork the repository.
  • Create a new branch.
  • Make your changes.
    • If you are adding a new feature, please include additional tests. The coverage threshold is 98%.
    • Create a conventional-commits compliant messages.
  • Ensure that everything is working (For example: npm run build)
  • Push the changes to your fork.
  • Create a pull request.
    • Describe your changes in detail.
    • Reference any related issues if applicable.

Code Reviews ​

All submissions, including submissions by project members, require review. We use GitHub pull requests for this purpose. Consult GitHub Help for more information on using pull requests.

License ​

The project is licensed under the Apache-2.0

Disclaimer: This is not an officially supported Google product.