First and foremost, we'd like to express our gratitude to you for taking the time to contribute. We don't accept feature contributions by the community as we are currently sticking to an internal roadmap. This may change in the future.
We welcome and appreciate all bug fix contributions via Pull Requests along the GitHub Flow.
Thanks!
For bug reports or requests, please submit your issue in the appropriate repository.
We advise that you open an issue and ask the CODEOWNERS and community prior to starting a contribution. This is your chance to ask questions and receive feedback before writing (potentially wrong) code. We value the direct contact with our community a lot, so don't hesitate to ask any questions.
For contributing to Terramate, please follow these steps:
- Within your fork of Terramate, create a branch for your contribution. Use a meaningful name.
- Create your contribution, meeting all contribution quality standards
- Create a pull request against the main branch of the Terramate repository.
- Work with your reviewers to address any comments and obtain a minimum of 1 approval.
- Once the pull request is approved, one of the maintainers will merge it.
Most quality and style standards are enforced automatically during integration testing. Your contribution needs to meet the following standards:
- Each contribution must have a single scope: one feature/bugfix/chore per PR
- Exceptions can be accepted if accompanied by good reasoning
- Include tests for any new functionality (or bug fix) in your pull request.
- Document all your public functions.
- When opening the PR, follow the instructions in the description template.
- If you need an early review, even if not ready, mark it as Draft.
- When ready to be reviewed, squash all commits into a single signed commit following the conventional commits convention.