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:
committed by
k8s-ci-robot
parent
560932ae4e
commit
200dd071a4
@@ -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 %}}
|
||||
|
||||
Reference in New Issue
Block a user