Add guidelines for working with localized content

zacharysarah · zacharysarah · commit a363f5d37dca · 2018-11-29T15:13:19.000-08:00
diff --git a/content/en/docs/contribute/intermediate.md b/content/en/docs/contribute/intermediate.md
@@ -806,6 +806,18 @@ content. See [Localization](/docs/contribute/localization/) and ask on the
 [kubernetes-sig-docs mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
 or in `#sig-docs` on Slack if you are interested in helping out.
 
+### Working with localized content
+
+Follow these guidelines for working with localized content:
+
+- Limit PRs to a single language. 
+
+   Each language has its own reviewers and approvers.
+
+- Reviewers, verify that PRs contain changes to only one language.
+
+   If a PR contains changes to source in more than one language, ask the PR contributor to open separate PRs for each language.
+
 {{% /capture %}}
 
 {{% capture whatsnext %}}
diff --git a/content/en/docs/contribute/start.md b/content/en/docs/contribute/start.md
@@ -24,12 +24,7 @@ code repositories, refer to
 
 ## The basics about our docs
 
-The Kubernetes documentation is written in Markdown and processed and deployed
-using Hugo. The source is in Github at
-[https://github.com/kubernetes/website](https://github.com/kubernetes/website).
-Most of the documentation source is stored in `/content/en/docs/`. Some of the
-reference documentation is automatically generated from scripts in the
-`update-imported-docs/` directory.
+The Kubernetes documentation is written in Markdown and processed and deployed using Hugo. The source is in Github at [https://github.com/kubernetes/website](https://github.com/kubernetes/website). Most of the documentation source is stored in `/content/en/docs/`. Some of the reference documentation is automatically generated from scripts in the `update-imported-docs/` directory.
 
 You can file issues, edit content, and review changes from others, all from the
 Github website. You can also use Github's embedded history and search tools.
@@ -70,6 +65,14 @@ We make use of the standard Hugo shortcodes, as well as a few that are custom to
 the Kubernetes documentation. See [Custom Hugo shortcodes](/docs/contribute/style/hugo-shortcodes/) for
 information about how to use them.
 
+### Multiple languages 
+
+Documentation source is available in multiple languages in `/content/`. Each language has its own folder with a two-letter code determined by the [ISO 639-1 standard](https://www.loc.gov/standards/iso639-2/php/code_list.php). For example, English documentation source is stored in `/content/en/docs/`. 
+
+For more information about contributing to documentation in multiple languages, see ["Working with localized content"](/docs/contribute/intermediate#working-with-localized-content) in the intermediate contributing guide.
+
+For more information about localizing Kubernetes documentation, see ["Localization"](/docs/contribute/localization/).
+
 ## File actionable issues
 
 Anyone with a Github account can file an issue (bug report) against the
