kubernetes / kubernetes/community

Need documentation for Leadership Change

Open
#9,122 0 comments 0 reactions 0 assignees View on GitHub
sig/contributor-experience
Dominant language
Jupyter Notebook
Stars
13k
Forks
5.4k
Avg merge
2d 17h
Merged PRs (30d)
29

Description

### Describe the issue

The currently Leadership Change checklist for SIGs is 15 items long. Many of these items have vague descriptions that assume that those carrying out the work already know where things are located and how to update them, which frequently they don't. Some items may be obsolete. This results in perpetually incomplete leadership change issues, and new sig-leads missing important communications.

Example: one thing that needs to happen is that the new lead is added to the sig-X-leads mailing list, which will be located under the SIG in the k8s.io repo. However, the current checklist just has a vague reference to "mailing lists".

Rather than adding increasingly detailed instructions in the checklist, it would be better to [complete the document](https://github.com/kubernetes/community/blob/main/contributors/chairs-and-techleads/leadership-changes.md) which explained exactly what each step required and where to find it.

Creating this issue as a bookmark.

/sig Contributor-Experience
attn: @palnabarun

Contributor guide

Open the contributing guide

Research direction

Start by reading contributors/chairs-and-techleads/leadership-changes.md and compare each checklist item with the current process described in the issue. Verify where SIG mailing lists and related updates are located in the k8s.io repository. Done means the document explains each current step, gives locations and instructions, and omits or resolves obsolete steps.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.