-
Notifications
You must be signed in to change notification settings - Fork 5.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add provisional KEP-1a: Meta KEP Implementation
Signed-off-by: Stephen Augustus <foo@agst.us>
- Loading branch information
1 parent
ca19b08
commit 2fba19d
Showing
1 changed file
with
199 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,199 @@ | ||
| --- | ||
| kep-number: 1a | ||
| title: Meta KEP Implementation | ||
| authors: | ||
| - "@justaugustus" | ||
| - "@calebamiles" | ||
| - "@jdumars" | ||
| owning-sig: sig-pm | ||
| participating-sigs: | ||
| - sig-architecture | ||
| reviewers: | ||
| - "@idvoretskyi" | ||
| - "@timothysc" | ||
| approvers: | ||
| - "@bgrant0607" | ||
| - "@jbeda" | ||
| editor: | ||
| creation-date: 2018-09-08 | ||
| last-updated: 2018-09-18 | ||
| status: provisional | ||
| see-also: | ||
| - KEP-1 | ||
| replaces: | ||
| superseded-by: | ||
| --- | ||
|
|
||
| # Meta KEP Implementation | ||
|
|
||
| ## Table of Contents | ||
|
|
||
| - [Table of Contents](#table-of-contents) | ||
| - [Summary](#summary) | ||
| - [Motivation](#motivation) | ||
| - [Why another KEP?](#why-another-kep) | ||
| - [Non-Goals](#non-goals) | ||
| - [Proposal](#proposal) | ||
| - [Implementation Details / Notes / Constraints](#implementation-details--notes--constraints) | ||
| - [Define](#define) | ||
| - [Organize](#organize) | ||
| - [Visibility and Automation](#visibility-and-automation) | ||
| - [Constraints](#constraints) | ||
| - [Graduation Criteria](#graduation-criteria) | ||
| - [Implementation History](#implementation-history) | ||
|
|
||
| ## Summary | ||
|
|
||
| Drive KEP adoption through improved process, documentation, visibility, and automation. | ||
|
|
||
| ## Motivation | ||
|
|
||
| The KEP process is the standardized structure for proposing changes to the Kubernetes project. | ||
|
|
||
| In order to graduate KEPs to GA, we must iterate over the implementation details. | ||
|
|
||
| This KEP seeks to define actionable / delegable items to move the process forward. | ||
|
|
||
| Finally, by submitting a KEP, we gain an opportunity to dogfood the process and further identify areas for improvement. | ||
|
|
||
| ### Why another KEP? | ||
|
|
||
| As [KEP-1] is currently de facto for the project, we must be careful to make changes to it in an iterative and atomic fashion. | ||
|
|
||
| When proposing a KEP, we action over some unit of work, usually some area of code. | ||
|
|
||
| In this instance, we treat [KEP-1] as the unit of work. That said, this would be considered a meta-KEP of the meta-KEP. | ||
|
|
||
| ### Non-Goals | ||
|
|
||
| - API Review process | ||
| - Feature request triage | ||
| - Developer guide | ||
|
|
||
| ## Proposal | ||
|
|
||
| ### Implementation Details / Notes / Constraints | ||
|
|
||
| #### Define | ||
|
|
||
| - Refine existing KEP documentation | ||
| - Define KEP [DACI] | ||
|
|
||
| #### Organize | ||
|
|
||
| - Move KEPs from flat-files to a directory structure: | ||
| ``` | ||
| ├── 001-introduction.md (required) | ||
| ├── 002-motivation.md (required) | ||
| ├── 003-goals.md | ||
| ├── 004-non-goals.md | ||
| ├── 005-guide-for-developers.md (required) | ||
| ├── 006-guide-for-teachers.md (required) | ||
| ├── 007-guide-for-operators.md (required) | ||
| ├── 008-guide-for-project-maintainers.md | ||
| ├── 009-graduation-criteria.md (required) | ||
| ├── 010-implementation-history.md | ||
| ├── experience_reports (required) | ||
| │ ├── alpha-feedback.md | ||
| │ └── beta-feedback.md | ||
| ├── features | ||
| │ ├── feature-01.md | ||
| │ ├── feature-02.md | ||
| │ └── feature-03.md | ||
| ├── index.json (required) | ||
| ├── metadata.yaml (required) | ||
| └── OWNERS | ||
| ``` | ||
|
|
||
| metadata.yaml contains information that was previously in a KEP's YAML front-matter: | ||
|
|
||
| ``` | ||
| --- | ||
| authors: # required | ||
| - "calebamiles" # just a GitHub handle for now | ||
| - "jbeda" | ||
| title: "Kubernetes Enhancement Proposal process" | ||
| number: 42 # required | ||
| owning-sig: "sig-pm" # required | ||
| participating-sigs: | ||
| - "sig-architecture" | ||
| - "sig-contributor-experience" | ||
| approvers: # required | ||
| - "bgrant0607" # just a GitHub handle for now | ||
| reviewers: | ||
| - "justaugustus" # just a GitHub handle for now | ||
| - "jdumars" | ||
| editors: | ||
| - null # generally omit empty/null fields | ||
| status: "active" # required | ||
| github: | ||
| issues: | ||
| - null # GitHub url | ||
| pull_requests: | ||
| - null # GitHub url | ||
| projects: | ||
| - project_id: null | ||
| card_id: null | ||
| releases: # required | ||
| - k8s_version: v1.9 | ||
| kep_status: "active" | ||
| k8s_status: "alpha" # one of alpha|beta|GA | ||
| - k8s_version: v1.10 | ||
| kep_status: "active" | ||
| k8s_status: "alpha" | ||
| replaces: | ||
| - kep_location: null | ||
| superseded-by: | ||
| - kep_location: null | ||
| created: 2018-01-22 # in YYYY-MM-DD | ||
| updated: 2018-09-04 | ||
| ``` | ||
|
|
||
| - Move KEPs into [k/features] | ||
| - Move design proposals into [k/features] | ||
| - Move architectural documents into [k/features] | ||
| - Deprecate design proposals | ||
| - Rename [k/features] to [k/keps] | ||
| - Create tombstones / redirects to [k/keps] | ||
| - Prevent new KEPs and design proposals from landing in [k/community] | ||
| - Correlate existing features with KEPs | ||
| - Fix [KEP numbering races] by using the GitHub issue number of the KEP tracking issue | ||
|
|
||
| #### Visibility and Automation | ||
|
|
||
| - Create tooling to present: | ||
| - KEPs, through some easy to use mechanism e.g., https://keps.k8s.io | ||
| - Project tracking across SIGs | ||
| - SIGs roadmaps | ||
|
|
||
| #### Constraints | ||
|
|
||
| - Preserve git history | ||
| - Preserve issues | ||
| - Preserve PRs | ||
|
|
||
| ## Graduation Criteria | ||
|
|
||
| Throughout implementation, we will be reaching out across the project to SIG leadership, approvers, and reviewers to capture feedback. | ||
|
|
||
| While graduation criteria has not strictly been defined at this stage, we will define it in future updates to this KEP. | ||
|
|
||
| ## Implementation History | ||
|
|
||
| - 2018-08-20: (@timothysc) Issue filed about repo separation: https://github.com/kubernetes/community/issues/2565 | ||
| - 2018-08-30: SIG Architecture meeting mentioning the need for a clearer KEP process - https://youtu.be/MMJ-zAR_GbI | ||
| - 2018-09-06: SIG Architecture meeting agreeing to move forward with a KEP process improvement effort to be co-led with SIG PM (@justaugustus / @jdumars) - https://youtu.be/fmlXkN4DJy0 | ||
| - 2018-09-10: KEP-1a submitted for review | ||
| - YYYY-MM-DD: the `Summary` and `Motivation` sections being merged signaling SIG acceptance | ||
| - YYYY-MM-DD: the `Proposal` section being merged signaling agreement on a proposed design | ||
| - YYYY-MM-DD: the date implementation started | ||
| - YYYY-MM-DD: the first Kubernetes release where an initial version of the KEP was available | ||
| - YYYY-MM-DD: the version of Kubernetes where the KEP graduated to general availability | ||
|
|
||
|
|
||
| [DACI]: https://www.atlassian.com/team-playbook/plays/daci | ||
| [KEP-1]: 0001-kubernetes-enhancement-proposal-process.md | ||
| [KEP numbering races]: https://github.com/kubernetes/community/issues/2245 | ||
| [k/community]: http://git.k8s.io/community | ||
| [k/features]: http://git.k8s.io/features | ||
| [k/keps]: http://git.k8s.io/keps |