When you have made changes to the codebase that you would like to contribute back, please follow these steps:
Search existing issues or create a new issue for the feature you are creating or the bug you are fixing. Our team will reach out and help provide feedback so that the path from Pull Request to Merge is as smooth and quick as possible. Each PR should be linked to an issue.
Fork the repository and create a new branch from dev.
Make changes and ensure that the code passes all tests. This can be done by navigating to pkg directory of the project and running go test ./....
All new features should include unit tests for the new functionality.
To test your changes with an end to end execution of the container, you can run docker-compose up --build cloud-concierge from the root of the repository.
If applicable, update the documentation to reflect your changes, if applicable.
Submit a pull request to the dev branch.
We will review your Pull Request as soon as possible (step 0. above will help expedite this process).
NOTE: We cannot guarantee that the default branch, dev, is stable. You should always use published releases for your production use.
After unit test, linter and code review requirements are met, pull requests are merged to the default dev branch.
We tag and deploy a beta release image off of the updated dev branch, and run additional end-to-end tests on this branch to ensure new features do not break existing functionality.
Once validated, we merge the dev branch to the prod branch, and tag and deploy a release image off of the prod branch to DockerHub. These images should be used in production.
Code of Conduct
We expect all contributors to follow our Code of Conduct when participating in our community. Please review prior to contributing.