Suggesting content improvements

    In most cases, new work on Kubernetes documentation begins with an issue in GitHub. Kubernetes contributors then review, categorize and tag issues as needed. Next, you or another member of the Kubernetes community open a pull request with changes to resolve the issue.

    1. Click the Create an issue link on the right sidebar. This redirects you to a GitHub issue page pre-populated with some headers.
    2. Click Submit new issue.

    After submitting, check in on your issue occasionally or turn on GitHub notifications. Reviewers and other community members might ask questions before they can take action on your issue.

    • Choose an existing page in the section you think the content belongs in and click Create an issue.
    • Go to GitHub and file the issue directly.

    Keep the following in mind when filing an issue:

    • Provide a clear issue description. Describe what specifically is missing, out of date, wrong, or needs improvement.
    • Limit the scope of a given issue to a reasonable unit of work. For problems with a large scope, break them down into smaller issues. For example, “Fix the security docs” is too broad, but “Add details to the ‘Restricting network access’ topic” is specific enough to be actionable.
    • Search the existing issues to see if there’s anything related or similar to the new issue.
    • If the new issue relates to another issue or pull request, refer to it either by its full URL or by the issue or pull request number prefixed with a character. For example, Introduced by #987654.
    • Follow the Code of Conduct. Respect your fellow contributors. For example, “The docs are terrible” is not helpful or polite feedback.