Branch: master
Find file History
Latest commit 65137e5 Feb 20, 2019
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
sig-api-machinery Fix spelling errors to enable spellcheck job Feb 19, 2019
sig-apps Updated OWNERS file to include link to docs Jan 30, 2019
sig-auth mv to sig-node Feb 5, 2019
sig-autoscaling Updated OWNERS file to include link to docs Jan 30, 2019
sig-aws Fix various spelling mistakes Feb 5, 2019
sig-azure Updated OWNERS file to include link to docs Jan 30, 2019
sig-cli Update kustomization integration to make it implementable. Jan 31, 2019
sig-cloud-provider Revert "Improve cloud provider docs KEP" Feb 12, 2019
sig-cluster-lifecycle Merge pull request #804 from fabriziopandini/set-implemented-certific… Feb 6, 2019
sig-contributor-experience Updated OWNERS file to include link to docs Jan 30, 2019
sig-instrumentation add a kep to wrap already exsting event design Feb 1, 2019
sig-network Mark service topology KEP implementable Feb 19, 2019
sig-node Fix spelling errors to enable spellcheck job Feb 19, 2019
sig-release rename KEP template to YYYYMMDD-kep-template.md Feb 15, 2019
sig-scheduling Fix typo Feb 4, 2019
sig-storage Fix various spelling mistakes Feb 5, 2019
sig-testing Merge pull request #782 from matthyx/master Feb 5, 2019
sig-windows Merge pull request #818 from PatrickLang/PodSecurityContext Feb 6, 2019
0001-kubernetes-enhancement-proposal-process.md Merge pull request #825 from verb/kep Feb 17, 2019
0001a-meta-kep-implementation.md Create KEPs directory Dec 1, 2018
OWNERS Remove sig/{architecture,pm} labels from KEP directory Feb 17, 2019
README.md Merge pull request #825 from verb/kep Feb 17, 2019
YYYYMMDD-kep-template.md rename KEP template to YYYYMMDD-kep-template.md Feb 15, 2019

README.md

Kubernetes Enhancement Proposals (KEPs)

A Kubernetes Enhancement Proposal (KEP) is a way to propose, communicate and coordinate on new efforts for the Kubernetes project. You can read the full details of the project in KEP-1.

This process is still in a beta state and is opt-in for those that want to provide feedback for the process.

Quick start for the KEP process

  1. Socialize an idea with a sponsoring SIG. Make sure that others think the work is worth taking up and will help review the KEP and any code changes required.
  2. Follow the process outlined in the KEP template

FAQs

Do I have to use the KEP process?

No... but we hope that you will. Over time having a rich set of KEPs in one place will make it easier for people to track what is going in the community and find a structured historic record.

KEPs are only required when the changes are wide ranging and impact most of the project. These changes are usually coordinated through SIG-Architecture. It is up to any specific SIG if they want to use the KEP process and when. The process is available to SIGs to use but not required.

Why would I want to use the KEP process?

Our aim with KEPs is to clearly communicate new efforts to the Kubernetes contributor community. As such, we want to build a well curated set of clear proposals in a common format with useful metadata.

Benefits to KEP users (in the limit):

  • Exposure on a kubernetes blessed web site that is findable via web search engines.
  • Cross indexing of KEPs so that users can find connections and the current status of any KEP.
  • A clear process with approvers and reviewers for making decisions. This will lead to more structured decisions that stick as there is a discoverable record around the decisions.

We are inspired by IETF RFCs, Pyton PEPs and Rust RFCs. See KEP-1 for more details.

Do I put my KEP in the root KEP directory or a SIG subdirectory?

If the KEP is mainly restricted to one SIG's purview then it should be in a KEP directory for that SIG. If the KEP is widely impacting much of Kubernetes, it should be put at the root of this directory. If in doubt ask SIG-Architecture and they can advise.

What will it take for KEPs to "graduate" out of "beta"?

Things we'd like to see happen to consider KEPs well on their way:

  • A set of KEPs that show healthy process around describing an effort and recording decisions in a reasonable amount of time.
  • KEPs exposed on a searchable and indexable web site.
  • Presubmit checks for KEPs around metadata format and markdown validity.

Even so, the process can evolve. As we find new techniques we can improve our processes.

My FAQ isn't answered here!

The KEP process is still evolving! If something is missing or not answered here feel free to reach out to SIG-Architecture. If you want to propose a change to the KEP process you can open a PR on KEP-1 with your proposal.