This repository is used to manage Kyverno Design Proposals (KDPs). A design proposal is recommend for any significant change, including new features and enhancements.

Older proposals were managed in documents. All new proposals should be submitted as a PR: https://github.com/kyverno/KDP/pulls.

To generate table of contents, visit this link.

To get a proposal into Kyverno, first, a KDP needs to be merged into the KDP repo. Once an KDP is merged, it's considered 'Accepted' and may be 'Implemented' to be included in the project. These steps will get an KDP to be considered:

1. Fork the KDP repo: https://github.com/kyverno/KDP
2. Copy template.md to proposals/feature.md (where 'my-feature' is descriptive.).
3. Fill in KDP. Any section can be marked as "N/A" if not applicable.
4. Submit a pull request. The pull request is the time to get review of the proposal from the larger community.
5. Build consensus and integrate feedback. KDPs that have broad support are much more likely to make progress than those that don't receive any comments.
6. Once the pull request is approved by two maintainers, the KDP will enter the 'Final Comment Period'.

When a pull request enters FCP the following will happen:

1. A maintainer will apply the "Final Comment Period" label.
2. The FCP will last 7 days. If there's unanimous agreement amongst the maintainers the FCP can close early.
3. For voting, the binding votes are comprised of the maintainers. Acceptance requires majority of binding votes in favor. The absence of a vote from a party with a binding vote in the process is considered to be a vote in the affirmative. Non-binding votes are of course welcome.
4. If no substantial new arguments or ideas are raised, the FCP will follow the outcome decided. If there are substantial new arguments, then the KDP will go back into development.