Contribute to Kubernetes docs

Kubernetes v1.12 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see latest version.

If you would like to help contribute to the Kubernetes documentation or website, we’re happy to have your help! Anyone can contribute, whether you’re new to the project or you’ve been around a long time, and whether you self-identify as a developer, an end user, or someone who just can’t stand seeing typos.

For more ways to get involved in the Kubernetes community or to learn about us, visit the Kubernetes community site. For information on the Kubernetes documentation style guide, see the style guide.

Types of contributors

A member of the Kubernetes organization who has signed the CLA and contributed some time and effort to the project. See Community membership for specific criteria for membership.

A SIG Docs reviewer is a member of the Kubernetes organization who has expressed interest in reviewing documentation pull requests and who has been added to the appropriate Github group and OWNERS files in the Github repository, by a SIG Docs Approver.

A SIG Docs approver is a member in good standing who has shown a continued commitment to the project. An approver can merge pull requests and publish content on behalf of the Kubernetes organization. Approvers can also represent SIG Docs in the larger Kubernetes community. Some of the duties of a SIG Docs approver, such as coordinating a release, require a significant time commitment.

Ways to contribute

This list is divided into things anyone can do, things Kubernetes organization members can do, and things that require a higher level of access and familiarity with SIG Docs processes. Contributing consistently over time can help you understand some of the tooling and organizational decisions that have already been made.

This is not an exhaustive list of ways you can contribute to the Kubernetes documentation, but it should help you get started.

Anyone

File actionable bugs

Member

Improve existing docs
Bring up ideas for improvement on Slack or the SIG docs mailing list
Improve docs accessibility
Provide non-binding feedback on PRs
Write a blog post or case study

Reviewer

Document new features
Triage and categorize issues
Review PRs
Create diagrams, graphics assets, and embeddable screencasts / videos
Localization
Contribute to other repos as a docs representative
Edit user-facing strings in code
Improve code comments, Godoc

Approver

Publish contributor content by approving and merging PRs
Participate in a Kubernetes release team as a docs representative
Propose improvements to the style guide
Propose improvements to docs tests
Propose improvements to the Kubernetes website or other tooling

Feedback

Was this page helpful?

Thanks for the feedback. If you have a specific, answerable question about how to use Kubernetes, ask it on Stack Overflow. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.