Support

Troubleshooting resources, frequently asked questions, and community support channels.

Edit This Page

Creating a fork of the Kubernetes documentation repository

To contribute to the Kubernetes documentation, create a pull request against the kubernetes/kubernetes.github.io repository. This page shows how to create a pull request.

Before you begin

  1. Create a GitHub account.

  2. Sign the Linux Foundation Contributor License Agreement.

Documentation will be published under the CC BY SA 4.0 license.

Creating a fork of the Kubernetes documentation repository

  1. Go to the kubernetes/kubernetes.github.io repository.

  2. In the upper-right corner, click Fork. This creates a copy of the Kubernetes documentation repository in your GitHub account. The copy is called a fork.

Making your changes

  1. In your GitHub account, in your fork of the Kubernetes docs, create a new branch to use for your contribution.

  2. In your new branch, make your changes and commit them. If you want to write a new topic, choose the page type that is the best fit for your content.

Submitting a pull request to the master branch (Current Release)

If you want your change to be published in the released version Kubernetes docs, create a pull request against the master branch of the Kubernetes documentation repository.

  1. In your GitHub account, in your new branch, create a pull request against the master branch of the kubernetes/kubernetes.github.io repository. This opens a page that shows the status of your pull request.

  2. Click Show all checks. Wait for the deploy/netlify check to complete. To the right of deploy/netlify, click Details. This opens a staging site where you can verify that your changes have rendered correctly.

  3. During the next few days, check your pull request for reviewer comments. If needed, revise your pull request by committing changes to your new branch in your fork.

Submitting a pull request to the <vnext> branch (Upcoming Release)

If your documentation change should not be released until the next release of the Kubernetes product, create a pull request against the <vnext> branch of the Kubernetes documentation repository. The <vnext> branch has the form release-<version-number>, for example release-1.5.

  1. In your GitHub account, in your new branch, create a pull request against the <vnext> branch of the kubernetes/kubernetes.github.io repository. This opens a page that shows the status of your pull request.

  2. Click Show all checks. Wait for the deploy/netlify check to complete. To the right of deploy/netlify, click Details. This opens a staging site where you can verify that your changes have rendered correctly.

  3. During the next few days, check your pull request for reviewer comments. If needed, revise your pull request by committing changes to your new branch in your fork.

What’s next

Analytics Create an Issue Edit this Page