We appreciate direct contributions to the provider codebase. Here's what to expect:
-
For pull requests that follow the guidelines, we will proceed to reviewing and merging, following the provider team's review schedule. There may be some internal or community discussion needed before we can complete this.
-
Pull requests that don't follow the guidelines will be commented with what they're missing. The person who submits the pull request or another community member will need to address those requests before they move forward.
-
Fork the GitHub repository, modify the code, and create a pull request.
You are welcome to submit your pull request for commentary or review before it is fully completed by creating a draft pull request.
Please include specific questions or items you'd like feedback on.
-
Once you believe your pull request is ready to be reviewed, ensure the pull request is not a draft pull request by marking it ready for review and a maintainer will review it.
-
One of Terraform provider team members will look over your contribution and either approve it or provide comments letting you know if there is anything left to do. We do our best to keep up with the volume of PRs waiting for review, but it will take some time for us to reach your PR based on the tasks we have in our backlog.
-
Once all outstanding comments and checklist items have been addressed, your contribution will be merged! Merged PRs will be included in the next release of the Terraform provider. The provider team takes care of updating the CHANGELOG as they merge.
-
In some cases, we might decide that a PR should be closed without merging. We'll make sure to provide clear reasoning when this happens.
The following Go language resources provide common coding preferences that may be referenced during review, if not automatically handled by the project's linting tools.