When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before submitting a change.
Issues can be tracked via [GitHub Issues].
We encourage a fork-based workflow, where experimental branches will live in your fork until they're ready to be submitted upstream via a PR.
- Fork this repository.
- Create a new branch of off master for your work.
- Update the [README] to document your change. See [Readme Driven Development] (or RDD!) for more information about this workflow.
- Update or add a breaking test for your change.
- Add your change until the tests pass.
- Add a note about your change to the [Unreleased] section of the [CHANGELOG].
- Squash or rebase your commits.
- Create a PR back to the master branch of this repo.
- The repo [CODEOWNERS] will be tagged for PR review.
- Once your change is approved, your PR will be merged.
- When maintainers create a new release, your [CHANGELOG] entry will be moved from the [Unreleased] section to the section for the new version.
- You've done it!
[GitHub Issues]: https://github.com/timoguin/aws-org-tools-py/issues). [README]: README.md [Readme Driven Development]: https://tom.preston-werner.com/2010/08/23/readme-driven-development.html [CHANGELOG]: CHANGELOG.md [Unreleased]: CHANGELOG.md#Unreleased [CODEOWNERS]: .github/CODEOWNERS