First: if you're unsure or afraid of anything, just ask or submit the issue or pull request anyways. You won't be yelled at for giving your best effort. The worst that can happen is that you'll be politely asked to change something. We appreciate any sort of contributions, and don't want a wall of rules to get in the way of that.
However, for those individuals who want a bit more guidance on the best way to contribute to the project, read on. This document will cover what we're looking for. By addressing all the points we're looking for, it raises the chances we can quickly merge or address your contributions.
Currently terraform-compliance supports 3 types of issue types ;
If you are going to reporting something else, please create a General Question issue.
Normally, we expect to have either a Bug Reporting or a Feature Request before having a Pull Request for in the codebase that will effect any functionality. This is not a hard requirement, you are free to create a new Pull Request if you find something is wrong or missing within the codebase or documentation.
There is few mandatory requirement for the Pull Requests ;
- All code changes that effects functionality MUST have tests implemented within the same Pull Request.
- Any functionality change must be recorded within the CHANGELOG.
- Your Pull Request must pass the CI in order to be processed.
Usually, Pull Requests are being processed within the same day, worst case your PR will wait for 1-2 days.
.
├── terraform_compliance
│ ├── common
│ ├── extensions
│ └── steps
├── docs
│ └── pages
│ ├── Examples
│ ├── bdd-references
│ ├── contribution
│ ├── installation
│ ├── usage
│ └── using-in-a-pipeline
└── tests
└── terraform_compliance
├── common
├── extensions
└── steps
All functionality defined in terraform_compliance directory where all test defined on tests with the same structure. So if you
change something in the terraform_compliance/steps, then the tests must exist in tests/steps.
terraform-compliance uses radish for the BDD framework, with lots of extensions written to parse and process
terraform files. Most of the functionality is described in https://terraform-compliance.com.
terraform-compliance uses Jekyll for templating and Github Pages for serving its website. https://terraform-compliance.com
Website is stored in docs directory, where in most cases changes in docs/pages will be sufficient for adding/removing/updating website pages.
Usually after every functionality change we try to release a new package immediately.