-
Notifications
You must be signed in to change notification settings - Fork 5.3k
Added doc on SIG Node KEP wrangler program #8614
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,104 @@ | ||
# SIG Node KEP Wrangler Program | ||
|
||
SIG Node is frequently the front-runner on completed KEP numbers in a given release. While we’ve historically been very productive, working on so many KEPs means things frequently fall between the cracks. In the retrospective for Kubernetes release v1.31.0 and subsequent conversations, the SIG discussed adding additional volunteers in the KEP wrangling process. This document describes this process and serves as a guide for new KEP wranglers to understand their responsibilities. | ||
|
||
## Responsibilities | ||
|
||
- Help guide contributors through the KEP process, ensuring they hit the various different deadlines (listed below) | ||
- Help communicate blockers/high priority issues (if any) to the SIG leads and chairs to help move them forward | ||
- Ensure someone responsible for the KEP is responding to the release and docs teams | ||
|
||
## Important deadlines | ||
|
||
As a KEP wrangler you should make sure that the KEPs assigned to you are abiding the following deadlines, as set by the release team: | ||
- PRR Freeze | ||
- Enhancements Freeze | ||
- Code/Test Freeze | ||
- Docs Freeze | ||
|
||
## Signing up to be a wrangler | ||
|
||
If you're interested in becoming a wrangler and helping us out, wait for the wrangler signup form in the [SIG Node mailing list](https://groups.google.com/g/kubernetes-sig-node) during the initial weeks of a release cycle. | ||
|
||
## Resources | ||
|
||
Wranglers should be part of the following channels in the Kubernetes Slack workspace: | ||
|
||
- [#sig-node-wranglers](https://kubernetes.slack.com/archives/C092ZDBRU64) | ||
- [#sig-node](https://kubernetes.slack.com/archives/C0BP8PW9G) | ||
|
||
## Process | ||
|
||
- At the start of the release, the SIG chairs would create a KEP planning board (You can find the v1.34 one [here](https://github.com/orgs/kubernetes/projects/214/views/2) for example) | ||
- Once the board is created and KEPs are added, feel free to assign KEPs to yourself by adding your name in the `Wranglers` column | ||
- Once you've assigned KEPs to yourself, follow up on the status of the KEPs and ping the KEP authors as and when necessary to make sure that all the different deadlines are met | ||
|
||
## Wrangler Lead | ||
|
||
In order to facilitate the wrangling process, we have a SIG Node KEP Wrangler lead. The person serving as the lead is responsible for making sure that KEPs are wrangled and that the reporting is done properly in that cycle. | ||
|
||
The responsibilities of the KEP wrangler lead includes the following: | ||
- Post the status of the KEPs each week in the [#sig-node-wranglers](https://kubernetes.slack.com/archives/C092ZDBRU64) channel | ||
- Collect applications for wranglers at the start of the release cycle by creating an interest form | ||
- Help new wranglers get familiar with the process and assist whenever needed | ||
- Send reminders before important deadlines like the enhancements and code freeze | ||
- Step in or delegate work if a wrangler assigned to a KEP is unavailable before important deadlines | ||
|
||
The SIG Node chairs selects a wrangler lead for each cycle. If you've been a KEP wrangler previously and would like to lead the wranglers, reach out to the SIG Node chairs in the [#sig-node-wranglers](https://kubernetes.slack.com/archives/C092ZDBRU64) channel. | ||
|
||
## Reporting | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. should we specify it's the wrangler lead for a release that posts these updates? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. also: I think codifying the role of wrangler lead in the process would be good. there is someone each time who wrangles the wranglers and we should document what that entails and what the selection process for that role could look like. could be rough There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. also happy to have that all be a follow up There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Please take a look at 0f2edc0! I've added a section for the wrangler lead's responsibilities. We can keep updating this over the course of v1.35 if we realize we need to add more details down the road. |
||
|
||
In order to assess the status of KEPs throughout the release, we plan to post a report of the KEPs every week in the [#sig-node-wranglers](https://kubernetes.slack.com/archives/C092ZDBRU64) channel. This can be done on Tuesdays before the weekly SIG Node meetings. | ||
|
||
Use the following templates to post the metrics of KEPs: | ||
|
||
#### Before enhancements freeze | ||
|
||
```md | ||
Metrics: | ||
|
||
By Stage | ||
- Alpha: | ||
- Beta: | ||
- Stable: | ||
- Deprecation: | ||
|
||
By Status | ||
- Tracked for enhancemnets freeze: | ||
- At risk for enhancements freeze: | ||
- Removed from milestone: | ||
``` | ||
|
||
#### Before code freeze | ||
|
||
```md | ||
Metrics: | ||
|
||
By Stage | ||
- Alpha: | ||
- Beta: | ||
- Stable: | ||
- Deprecation: | ||
|
||
By Status | ||
- Tracked for code freeze: | ||
- At risk for code freeze: | ||
- Removed from milestone: | ||
``` | ||
|
||
#### Before docs freeze | ||
|
||
```md | ||
Metrics: | ||
|
||
By Stage | ||
- Alpha: | ||
- Beta: | ||
- Stable: | ||
- Deprecation: | ||
|
||
By Status | ||
- Tracked for docs freeze: | ||
- At risk for docs freeze: | ||
- Removed from milestone: | ||
``` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
One responsibility missing is gathering the wranglers through an interest form
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Added, thanks!