Fix tocs and template in docs/home/contribute (#8998)

These pages did not use any template and the displayed toc started
with two bullet points.

Fixes:
* Use the concept template everywhere and add capture markers.
* Rework content-organization.md to move the references to a "whatsnext"
  section.
* Fix in localization.md a misparsed list.
This commit is contained in:
Andreas Jaeger
2018-06-08 20:32:54 +02:00
committed by k8s-ci-robot
parent 560932ae4e
commit 200dd071a4
2 changed files with 33 additions and 6 deletions
@@ -1,14 +1,23 @@
---
title: Localizing Kubernetes Documentation
content_template: templates/concept
approvers:
- chenopis
- zacharysarah
---
{{% capture overview %}}
We're happy to add localizations (l10n) of Kubernetes documentation to the website!
Localizations must meet the following requirements for _workflow_ (how to localize) and _output_ (what to localize).
{{% /capture %}}
{{< toc >}}
{{% capture body %}}
## Workflow
All l10n work must be stored and tracked within the [Kubernetes organization](https://github.com/kubernetes).
@@ -72,12 +81,18 @@ Home | [All heading and subheading URLs](https://kubernetes.io/docs/home/)
Setup | [All heading and subheading URLs](https://kubernetes.io/docs/setup/)
Tutorials | [Kubernetes Basics](https://kubernetes.io/docs/tutorials/), [Hello Minikube](https://kubernetes.io/docs/tutorials/stateless-application/hello-minikube/)
## Next steps
{{% /capture %}}
{{% capture whatsnext %}}
Once a l10n meets requirements for workflow and minimum output, SIG docs will:
- Work with the localization team to implement language selection on the website
- Work with the localization team to implement language selection on the website.
- Publicize availability through [Cloud Native Computing Foundation](https://www.cncf.io/) (CNCF) channels.
{{< note >}}
**Note:** Implementation of language selection is pending Kubernetes' first completed localization project.
{{< /note >}}
{{% /capture %}}