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,16 +1,19 @@
---
title: Content Organization
date: 2018-04-30
content_template: templates/concept
weight: 42
---
{{< toc >}}
{{% capture overview %}}
This site uses Hugo. In Hugo, [content organization](https://gohugo.io/content-management/organization/) is a core concept.
Also see:
* [Custom Hugo Shortcodes](/docs/home/contribute/includes)
* [Style Guide](/docs/home/contribute/style-guide)
{{% /capture %}}
{{% capture body %}}
{{% note %}}
**Hugo Tip:** Start Hugo with `hugo server --navigateToChanged` for content edit-sessions.
@@ -128,3 +131,12 @@ Some important notes to the files in the bundles:
The `SASS` source of the stylesheets for this site is stored below `src/sass` and can be built with `make sass` (note that Hugo will get `SASS` support soon, see https://github.com/gohugoio/hugo/issues/4243).
{{% /capture %}}
{{% capture whatsnext %}}
* [Custom Hugo Shortcodes](/docs/home/contribute/includes)
* [Style Guide](/docs/home/contribute/style-guide)
{{% /capture %}}
@@ -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 %}}