2020-06-19 22:47:17 +00:00
# Contributing
Hi there! I'm thrilled that you'd like to contribute to this project. Your help is essential for keeping it great.
2020-12-26 17:32:24 +00:00
Contributions to this project are [released ](https://help.github.com/articles/github-terms-of-service/#6-contributions-under-repository-license )
2021-06-25 21:24:02 +00:00
to the public under the [project's open source license ]([[ config.repo_url ]]/blob/master/LICENSE ).
2020-06-19 22:47:17 +00:00
## Submitting a pull request
2021-06-25 21:24:02 +00:00
1. [Fork ]([[ config.repo_url ]]fork ) and clone the repository
2020-06-19 22:47:17 +00:00
2. Configure and install the dependencies: `go mod download`
3. Create a new branch: `git checkout -b my-branch-name`
4. Make your changes
2020-12-26 17:32:24 +00:00
5. Validate: `docker buildx bake validate`
6. Test your code: `docker buildx bake test`
7. Build the project: `docker buildx bake artifact-all image-all`
2021-06-25 21:24:02 +00:00
8. Push to your fork and [submit a pull request ]([[ config.repo_url ]]compare )
2020-12-26 17:32:24 +00:00
9. Pat your self on the back and wait for your pull request to be reviewed and merged.
2020-06-19 22:47:17 +00:00
Here are a few things you can do that will increase the likelihood of your pull request being accepted:
* Make sure the `README.md` and any other relevant **documentation are kept up-to-date** .
* I try to follow [SemVer v2.0.0 ](https://semver.org/ ). Randomly breaking public APIs is not an option.
* Keep your change as focused as possible. If there are multiple changes you would like to make that are not dependent upon each other, consider submitting them as **separate pull requests** .
* Write a [good commit message ](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html ).
2021-04-28 21:45:07 +00:00
## Documentation
If you want to contribute to the documentation you can test its rendering locally with the following commands:
```shell
# Build mkdocs image
docker build -t mkdocs -f ./hack/docs.Dockerfile --target base .
# Run mkdocs image and watch for changes
docker run --rm -it -p 8000:8000 -v $(pwd):/docs mkdocs
# Open http://localhost:8000 on your browser
```
2020-06-19 22:47:17 +00:00
## Resources
* [How to Contribute to Open Source ](https://opensource.guide/how-to-contribute/ )
2020-12-26 17:32:24 +00:00
* [Using Pull Requests ](https://docs.github.com/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/about-pull-requests )
* [GitHub Help ](https://docs.github.com )