Contribute to K8s docs

Kubernetes welcomes improvements from all contributors, new and experienced!

Note: To learn more about contributing to Kubernetes in general, see the contributor documentation.

This website is maintained by Kubernetes SIG Docs.

Kubernetes documentation contributors:

• Improve existing content
• Create new content
• Translate the documentation
• Manage and publish the documentation parts of the Kubernetes release cycle

Getting started

Anyone can open an issue about documentation, or contribute a change with a pull request (PR) to the kubernetes/website GitHub repository. You need to be comfortable with git and GitHub to work effectively in the Kubernetes community.

To get involved with documentation:

1. Sign the CNCF Contributor License Agreement.
2. Familiarize yourself with the documentation repository and the website’s static site generator.
3. Make sure you understand the basic processes for opening a pull request and reviewing changes.

Some tasks require more trust and more access in the Kubernetes organization. See Participating in SIG Docs for more details about roles and permissions.

Your first contribution

• Read the Contribution overview to learn about the different ways you can contribute.
• Check kubernetes/website issues list for issues that make good entry points.
• Open a pull request using GitHub to existing documentation and learn more about filing issues in GitHub.
• Review pull requests from other Kubernetes community members for accuracy and language.
• Read the Kubernetes content and style guides so you can leave informed comments.
• Learn about page content types and Hugo shortcodes.

Next steps

• Learn to work from a local clone of the repository.

• Document features in a release.

• Participate in SIG Docs, and become a member or reviewer.

• Start or help with a localization.

Get involved with SIG Docs

SIG Docs is the group of contributors who publish and maintain Kubernetes documentation and the website. Getting involved with SIG Docs is a great way for Kubernetes contributors (feature development or otherwise) to have a large impact on the Kubernetes project.

SIG Docs communicates with different methods:

• Join #sig-docs on the Kubernetes Slack instance. Make sure to introduce yourself!
• Join the kubernetes-sig-docs mailing list, where broader discussions take place and official decisions are recorded.
• Join the weekly SIG Docs video meeting. Meetings are always announced on #sig-docs and added to the Kubernetes community meetings calendar. You’ll need to download the Zoom client or dial in using a phone.

Other ways to contribute

• Visit the Kubernetes community site. Participate on Twitter or Stack Overflow, learn about local Kubernetes meetups and events, and more.
• Read the contributor cheatsheet to get involved with Kubernetes feature development.
• Submit a blog post or case study.