diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 7ea582a061..fe04ebe612 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -5,17 +5,24 @@ We welcome all contributions, suggestions, and feedback, so please do not hesita Before you contribute, please take a moment to review and agree to abide by our community [Code of Conduct](/CODE_OF_CONDUCT.md). - [Contributing Guidelines for Kyverno](#contributing-guidelines-for-kyverno) - - [Ways you can contribute](#ways-you-can-contribute) - - [Report issues](#report-issues) - - [Fix or Improve Documentation](#fix-or-improve-documentation) - - [Submit Pull Requests](#submit-pull-requests) - - [How to Create a PR](#how-to-create-a-pr) - [Engage with us](#engage-with-us) - - [Developer Certificate of Origin (DCO) Sign off](#developer-certificate-of-origin-dco-sign-off) + - [Ways you can contribute](#ways-you-can-contribute) + - [1. Report issues](#1-report-issues) + - [2. Fix or Improve Documentation](#2-fix-or-improve-documentation) + - [3. Submit Pull Requests](#3-submit-pull-requests) + - [How to Create a PR](#how-to-create-a-pr) + - [Developer Certificate of Origin (DCO) Sign off](#developer-certificate-of-origin-dco-sign-off) + - [Release Processes](#release-processes) + +## Engage with us + +The Kyverno website has the most updated information on [how to engage with the Kyverno community](https://kyverno.io/community/) including its maintainers and contributors. + +Join our community meetings to learn more about Kyverno and engage with other contributors. ## Ways you can contribute -### Report issues +### 1. Report issues Issues to Kyverno help improve the project in multiple ways including the following: @@ -23,11 +30,11 @@ Issues to Kyverno help improve the project in multiple ways including the follow - Request a feature - Request a sample policy -### Fix or Improve Documentation +### 2. Fix or Improve Documentation The [Kyverno website](https://kyverno.io), like the main Kyverno codebase, is stored in its own [git repo](https://github.com/kyverno/website). To get started with contributions to the documentation, [follow the guide](https://github.com/kyverno/website#contributing) on that repository. -### Submit Pull Requests +### 3. Submit Pull Requests [Pull requests](https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) (PRs) allow you to contribute back the changes you've made on your side enabling others in the community to benefit from your hard work. They are the main source by which all changes are made to this project and are a standard piece of GitHub operational flows. @@ -42,7 +49,7 @@ In the process of submitting your PRs, please read and abide by the template pro 3. Test your change with the [Kyverno CLI](https://kyverno.io/docs/kyverno-cli/) and provide a test manifest in the proper format. If your feature/fix does not work with the CLI, a separate issue requesting CLI support must be made. 4. Indicate which release this PR is triaged for (maintainers). This step is important especially for the documentation maintainers in order to understand when and where the necessary changes should be made. -## How to Create a PR +#### How to Create a PR Head over to the project repository on GitHub and click the **"Fork"** button. With the forked copy, you can try new ideas and implement changes to the project. @@ -84,11 +91,7 @@ Go ahead and push your changes to GitHub using this command. git push ``` -## Engage with us - -The website has the most updated information on [how to engage with the Kyverno community](https://kyverno.io/community/) including its maintainers and contributors. - -## Developer Certificate of Origin (DCO) Sign off +#### Developer Certificate of Origin (DCO) Sign off For contributors to certify that they wrote or otherwise have the right to submit the code they are contributing to the project, we are requiring everyone to acknowledge this by signing their work which indicates you agree to the DCO found [here](https://developercertificate.org/). @@ -103,3 +106,7 @@ This can easily be done with the `-s` command line option to append this automat ```sh git commit -s -m 'This is my commit message' ``` + +## Release Processes + +Review the Kyverno release process at: https://kyverno.io/docs/releases/ \ No newline at end of file