Go to file
Samuel Kihahu 767f9fb0c0 en-docs: Add kubectl Installation Via Homebrew (#17928) 2019-12-06 07:34:51 -08:00
.github
archetypes Convert site to Hugo (#8316) 2018-05-05 09:00:51 -07:00
assets/sass Add YouTube social button in header and footer (#16838) 2019-12-04 15:22:31 -08:00
content en-docs: Add kubectl Installation Via Homebrew (#17928) 2019-12-06 07:34:51 -08:00
data fix some broken links (#17851) 2019-11-27 21:05:03 -08:00
functions-src
i18n Add YouTube social button in header and footer (#16838) 2019-12-04 15:22:31 -08:00
layouts Add YouTube social button in header and footer (#16838) 2019-12-04 15:22:31 -08:00
scripts
static Add YouTube social button in header and footer (#16838) 2019-12-04 15:22:31 -08:00
update-imported-docs Update script for Python3, PyYAML 5.1.2 (#17127) 2019-10-22 14:04:18 -07:00
.dockerignore
.editorconfig
.gitignore
CONTRIBUTING.md
Dockerfile
LICENSE
Makefile Fixed hot reload panic of local hugo issue. (#17894) 2019-12-03 23:06:57 -08:00
OWNERS
OWNERS_ALIASES Freshen the list of English content approvers for SIG Docs (#17929) 2019-12-04 12:48:57 -08:00
README-de.md
README-es.md
README-fr.md
README-hi.md
README-id.md
README-ja.md
README-ko.md Update README-ko.md (#17366) 2019-11-03 05:23:39 -08:00
README-pt.md
README-ru.md Init Russian localization (#16404) 2019-11-14 14:15:14 -08:00
README-vi.md
README-zh.md
README.md Init Russian localization (#16404) 2019-11-14 14:15:14 -08:00
SECURITY_CONTACTS
code-of-conduct.md
config.toml Init Russian localization (#16404) 2019-11-14 14:15:14 -08:00
labels.yaml
netlify.toml
package.json

README.md

The Kubernetes documentation

Build Status GitHub release

Welcome! This repository houses all of the assets required to build the Kubernetes website and documentation. We're glad that you want to contribute!

Contributing to the docs

You can click the Fork button in the upper-right area of the screen to create a copy of this repository in your GitHub account. This copy is called a fork. Make any changes you want in your fork, and when you are ready to send those changes to us, go to your fork and create a new pull request to let us know about it.

Once your pull request is created, a Kubernetes reviewer will take responsibility for providing clear, actionable feedback. As the owner of the pull request, it is your responsibility to modify your pull request to address the feedback that has been provided to you by the Kubernetes reviewer. Also, note that you may end up having more than one Kubernetes reviewer provide you feedback or you may end up getting feedback from a Kubernetes reviewer that is different than the one initially assigned to provide you feedback. Furthermore, in some cases, one of your reviewers might ask for a technical review from a Kubernetes tech reviewer when needed. Reviewers will do their best to provide feedback in a timely fashion but response time can vary based on circumstances.

For more information about contributing to the Kubernetes documentation, see:

Localization README.md's

French README Korean README
German README Portuguese README
Hindi README Spanish README
Indonesian README Chinese README
Japanese README Vietnamese README
Russian README

Running the website locally using Docker

The recommended way to run the Kubernetes website locally is to run a specialized Docker image that includes the Hugo static website generator.

If you are running on Windows, you'll need a few more tools which you can install with Chocolatey. choco install make

If you'd prefer to run the website locally without Docker, see Running the website locally using Hugo below.

If you have Docker up and running, build the kubernetes-hugo Docker image locally:

make docker-image

Once the image has been built, you can run the website locally:

make docker-serve

Open up your browser to http://localhost:1313 to view the website. As you make changes to the source files, Hugo updates the website and forces a browser refresh.

Running the website locally using Hugo

See the official Hugo documentation for Hugo installation instructions. Make sure to install the Hugo extended version specified by the HUGO_VERSION environment variable in the netlify.toml file.

To run the website locally when you have Hugo installed:

make serve

This will start the local Hugo server on port 1313. Open up your browser to http://localhost:1313 to view the website. As you make changes to the source files, Hugo updates the website and forces a browser refresh.

Community, discussion, contribution, and support

Learn how to engage with the Kubernetes community on the community page.

You can reach the maintainers of this project at:

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.

Thank you!

Kubernetes thrives on community participation, and we appreciate your contributions to our website and our documentation!