fix typo ref contrib (#11096)
This commit is contained in:
committed by
k8s-ci-robot
parent
d3eaeef3fc
commit
9a34fa470d
@@ -12,7 +12,6 @@ reference documentation for tools and components in the
|
|||||||
|
|
||||||
{{% /capture %}}
|
{{% /capture %}}
|
||||||
|
|
||||||
|
|
||||||
{{% capture prerequisites %}}
|
{{% capture prerequisites %}}
|
||||||
|
|
||||||
* You need a machine that is running Linux or macOS.
|
* You need a machine that is running Linux or macOS.
|
||||||
@@ -36,7 +35,6 @@ information, see
|
|||||||
|
|
||||||
{{% /capture %}}
|
{{% /capture %}}
|
||||||
|
|
||||||
|
|
||||||
{{% capture steps %}}
|
{{% capture steps %}}
|
||||||
|
|
||||||
## Getting two repositories
|
## Getting two repositories
|
||||||
@@ -115,9 +113,8 @@ need to work with someone who can set the label and milestone for you.
|
|||||||
|
|
||||||
## Overview of update-imported-docs
|
## Overview of update-imported-docs
|
||||||
|
|
||||||
The website repository contains a `update-imported-docs` tool under the
|
The `update-imported-docs` tool is located in the `kubernetes/website/update-imported-docs/`
|
||||||
`kubernetes/website/update-imported-docs/` directory that performs the
|
directory. The tool performs the following steps:
|
||||||
following steps:
|
|
||||||
|
|
||||||
1. Clones the related repositories specified in a configuration file. For the
|
1. Clones the related repositories specified in a configuration file. For the
|
||||||
purpose of generating reference docs, the repositories that are cloned by
|
purpose of generating reference docs, the repositories that are cloned by
|
||||||
@@ -134,8 +131,8 @@ to `kubernetes/website`.
|
|||||||
|
|
||||||
## Customizing the config file
|
## Customizing the config file
|
||||||
|
|
||||||
Open `<web-base>/update-imported-docs/reference.yaml` for editing.
|
Open `<web-base>/update-imported-docs/reference.yml` for editing.
|
||||||
Do not change the content for the `generate-command` entry unless you undertand
|
Do not change the content for the `generate-command` entry unless you understand
|
||||||
what it is doing and need to change the specified release branch.
|
what it is doing and need to change the specified release branch.
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
@@ -159,8 +156,9 @@ repos:
|
|||||||
make comp
|
make comp
|
||||||
```
|
```
|
||||||
|
|
||||||
The `update-imported-docs` tool uses `src` and `dst` fields in a configuration
|
In reference.yml, the `files` field is a list of `src` and `dst` fields. The `src` field
|
||||||
to decide the source and target location for doc files to be copied.
|
specifies the location of a generated Markdown file, and the `dst` field specifies
|
||||||
|
where to copy this file in the cloned `kubernetes/website` repository.
|
||||||
For example:
|
For example:
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
@@ -241,5 +239,3 @@ topics will be visible in the
|
|||||||
* [Generating Reference Documentation for the Kubernetes Federation API](/docs/home/contribute/generated-reference/federation-api/)
|
* [Generating Reference Documentation for the Kubernetes Federation API](/docs/home/contribute/generated-reference/federation-api/)
|
||||||
|
|
||||||
{{% /capture %}}
|
{{% /capture %}}
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user