Skip to content

Contributor Documentation Touchups #716

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.

Sign up for GitHub

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

Draft
ciarandg wants to merge 3 commits into
base: main
Choose a base branch
from
Draft

Contributor Documentation Touchups #716

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
dfdaf6b
Add missing links to CONTRIBUTING.md
ciarandg Jan 25, 2026
e9fc914
Fix typo
ciarandg Jan 27, 2026
746e8d6
Add docs for promotions
ciarandg Jan 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,9 @@ Should you do this, please make sure to add your initials, name and contact link

All contributors will be honored in the Authors.md file for a year or more after their last contribution.

## Developer News
## Sections

### Developer News

Developer News should include anything of interest to the whole pool of Kubernetes developers, which should include:

Expand All @@ -50,14 +52,18 @@ Developer News should include anything of interest to the whole pool of Kubernet

Sources of this information include, but are not limited to:

* The kubernetes.io/dev mailing list archives
* Kubernetes.dev/events website and the Summit Team
* The [kubernetes-dev](https://groups.google.com/a/kubernetes.io/g/dev) mailing list archives
Copy link
Copy Markdown
Contributor Author

@ciarandg ciarandg Jan 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

note: The rewording here aligns with the contributor cheatsheet and also avoids the potential misconception that kubernetes.io/dev is referring to a URL rather than a Google Group

* [kubernetes.dev/events](https://www.kubernetes.dev/events/) website and the Summit Team
* Chairs and Leads slack channel
* Issues and PRs in Community, Enhancements, and Test-Infra repos
* Steering committee meeting minutes
* The [Contributor Comms Meeting notes](https://docs.google.com/document/d/1KxutG0BivRcOtm9yxTrNRhq51qEE7wY0ZibyDTxrjtM/edit?tab=t.0)
from the prior week (link is to 2025 edition)

### Promotions

Promotions should include all features that have been promoted to a new stage. `test/compatibility_lifecycle/reference/versioned_feature_list.yaml` is the source of truth for feature gates, so you can check its commit history for relevant changes.

## Searching for PRs

We search for significant PRs merged in the last week against kubernetes/kubernetes using this github query:
Expand Down
2 changes: 1 addition & 1 deletion STYLESHEET.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ The audience for LWKD is, in priority order:
2. Contributors to closely related projects
3. Engineers and documentation writers who work on Kubernetes distributions

Kubernetes users are not our audience, unless the are the kind of power user who tests alpha versions.
Kubernetes users are not our audience, unless they are the kind of power user who tests alpha versions.

## Mission

Expand Down