@@ -27,7 +27,7 @@ API or the `kube-*` components from the upstream code, see the following instruc
27
27
- [Generating Reference Documentation for the Kubernetes API](/docs/contribute/generate-ref-docs/kubernetes-api/)
28
28
- [Generating Reference Documentation for the Kubernetes Components and Tools](/docs/contribute/generate-ref-docs/kubernetes-components/)
29
29
-->
30
- 如果您仅想从上游代码重新生成 Kubernetes API 或 ` kube-* ` 组件的参考文档。请参考以下说明:
30
+ 如果你仅想从上游代码重新生成 Kubernetes API 或 ` kube-* ` 组件的参考文档。请参考以下说明:
31
31
32
32
- [ 生成 Kubernetes API 的参考文档] ( /zh/docs/contribute/generate-ref-docs/kubernetes-api/ )
33
33
- [ 生成 Kubernetes 组件和工具的参考文档] ( /zh/docs/contribute/generate-ref-docs/kubernetes-components/ )
@@ -65,7 +65,7 @@ You need to have these tools installed:
65
65
[Creating a Pull Request](https://help.github.com/articles/creating-a-pull-request/) and
66
66
[GitHub Standard Fork & Pull Request Workflow](https://gist.github.com/Chaser324/ce0505fbed06b947d962).
67
67
-->
68
- - 您需要知道如何创建对 GitHub 代码仓库的拉取请求(Pull Request)。
68
+ - 你需要知道如何创建对 GitHub 代码仓库的拉取请求(Pull Request)。
69
69
通常,这涉及创建代码仓库的派生副本。
70
70
要获取更多的信息请参考[ 创建 PR] ( https://help.github.com/articles/creating-a-pull-request/ ) 和
71
71
[ GitHub 标准派生和 PR 工作流程] ( https://gist.github.com/Chaser324/ce0505fbed06b947d962 ) 。
@@ -87,7 +87,7 @@ creating a patch to fix it in the upstream project.
87
87
Kubernetes API 和 ` kube-* ` 组件(例如 ` kube-apiserver ` 、` kube-controller-manager ` )的参考文档
88
88
是根据[ 上游 Kubernetes] ( https://github.com/kubernetes/kubernetes/ ) 中的源代码自动生成的。
89
89
90
- 当您在生成的文档中看到错误时,您可能需要考虑创建一个 PR 用来在上游项目中对其进行修复。
90
+ 当你在生成的文档中看到错误时,你可能需要考虑创建一个 PR 用来在上游项目中对其进行修复。
91
91
92
92
<!--
93
93
## Cloning the Kubernetes repository
@@ -96,7 +96,7 @@ If you don't already have the kubernetes/kubernetes repository, get it now:
96
96
-->
97
97
## 克隆 Kubernetes 代码仓库
98
98
99
- 如果您还没有 kubernetes/kubernetes 代码仓库,请参照下列命令获取:
99
+ 如果你还没有 kubernetes/kubernetes 代码仓库,请参照下列命令获取:
100
100
101
101
``` shell
102
102
mkdir $GOPATH /src
@@ -111,7 +111,7 @@ For example, if you followed the preceding step to get the repository, your
111
111
base directory is `$GOPATH/src/github.com/kubernetes/kubernetes.`
112
112
The remaining steps refer to your base directory as `<k8s-base>`.
113
113
-->
114
- 确定您的 [ kubernetes/kubernetes] ( https://github.com/kubernetes/kubernetes ) 代码仓库克隆的根目录。
114
+ 确定你的 [ kubernetes/kubernetes] ( https://github.com/kubernetes/kubernetes ) 代码仓库克隆的根目录。
115
115
例如,如果按照前面的步骤获取代码仓库,则你的根目录为 ` $GOPATH/src/github.com/kubernetes/kubernetes ` 。
116
116
接下来其余步骤将你的根目录称为 ` <k8s-base> ` 。
117
117
@@ -122,7 +122,7 @@ For example, if you followed the preceding step to get the repository, your
122
122
base directory is `$GOPATH/src/github.com/kubernetes-sigs/reference-docs.`
123
123
The remaining steps refer to your base directory as `<rdocs-base>`.
124
124
-->
125
- 确定您的 [ kubernetes-sigs/reference-docs] ( https://github.com/kubernetes-sigs/reference-docs )
125
+ 确定你的 [ kubernetes-sigs/reference-docs] ( https://github.com/kubernetes-sigs/reference-docs )
126
126
代码仓库克隆的根目录。
127
127
例如,如果按照前面的步骤获取代码仓库,则你的根目录为
128
128
` $GOPATH/src/github.com/kubernetes-sigs/reference-docs ` 。
@@ -146,7 +146,7 @@ The documentation for the `kube-*` components is also generated from the upstrea
146
146
source code. You must change the code related to the component
147
147
you want to fix in order to fix the generated documentation.
148
148
-->
149
- ` kube-* ` 组件的文档也是从上游源代码生成的。您必须更改与要修复的组件相关的代码 ,才能修复生成的文档。
149
+ ` kube-* ` 组件的文档也是从上游源代码生成的。你必须更改与要修复的组件相关的代码 ,才能修复生成的文档。
150
150
151
151
<!--
152
152
### Making changes to the upstream source code
@@ -168,7 +168,7 @@ and make sure it is up to date:
168
168
-->
169
169
以下在 Kubernetes 源代码中编辑注释的示例。
170
170
171
- 在您本地的 kubernetes/kubernetes 代码仓库中,检出默认分支,并确保它是最新的:
171
+ 在你本地的 kubernetes/kubernetes 代码仓库中,检出默认分支,并确保它是最新的:
172
172
173
173
``` shell
174
174
cd < k8s-base>
@@ -200,7 +200,7 @@ git status
200
200
The output shows that you are on the master branch, and that the `types.go`
201
201
source file has been modified:
202
202
-->
203
- 输出显示您在 master 分支上,` types.go ` 源文件已被修改:
203
+ 输出显示你在 master 分支上,` types.go ` 源文件已被修改:
204
204
205
205
``` shell
206
206
On branch master
@@ -217,7 +217,7 @@ you will do a second commit. It is important to keep your changes separated into
217
217
### 提交已编辑的文件
218
218
219
219
运行 ` git add ` 和 ` git commit ` 命令提交到目前为止所做的更改。
220
- 在下一步中,您将进行第二次提交 ,将更改分成两个提交很重要。
220
+ 在下一步中,你将进行第二次提交 ,将更改分成两个提交很重要。
221
221
222
222
<!--
223
223
### Generating the OpenAPI spec and related files
@@ -254,17 +254,17 @@ This is important, because `swagger.json` is the input to the second stage of
254
254
the doc generation process.
255
255
-->
256
256
查看 ` api/openapi-spec/swagger.json ` 的内容,以确保拼写错误已经被修正。
257
- 例如,您可以运行 ` git diff -a api/openapi-spec/swagger.json ` 命令。
257
+ 例如,你可以运行 ` git diff -a api/openapi-spec/swagger.json ` 命令。
258
258
这很重要,因为 ` swagger.json ` 是文档生成过程中第二阶段的输入。
259
259
260
260
<!--
261
261
Run `git add` and `git commit` to commit your changes. Now you have two commits:
262
262
one that contains the edited `types.go` file, and one that contains the generated OpenAPI spec
263
263
and related files. Keep these two commits separate. That is, do not squash your commits.
264
264
-->
265
- 运行 ` git add ` 和 ` git commit ` 命令来提交您的更改。现在您有两个提交 (commits):
265
+ 运行 ` git add ` 和 ` git commit ` 命令来提交你的更改。现在你有两个提交 (commits):
266
266
一种包含编辑的 ` types.go ` 文件,另一种包含生成的 OpenAPI 规范和相关文件。
267
- 将这两个提交分开独立。也就是说,不要 squash 您的提交 。
267
+ 将这两个提交分开独立。也就是说,不要 squash 你的提交 。
268
268
269
269
<!--
270
270
Submit your changes as a
@@ -274,9 +274,9 @@ master branch of the
274
274
Monitor your pull request, and respond to reviewer comments as needed. Continue
275
275
to monitor your pull request until it is merged.
276
276
-->
277
- 将您的更改作为 [ PR] ( https://help.github.com/articles/creating-a-pull-request/ )
277
+ 将你的更改作为 [ PR] ( https://help.github.com/articles/creating-a-pull-request/ )
278
278
提交到 [ kubernetes/kubernetes] ( https://github.com/kubernetes/kubernetes ) 代码仓库的 master 分支。
279
- 关注您的 PR,并根据需要回复 reviewer 的评论。继续关注您的 PR,直到 PR 被合并为止。
279
+ 关注你的 PR,并根据需要回复 reviewer 的评论。继续关注你的 PR,直到 PR 被合并为止。
280
280
281
281
<!--
282
282
[PR 57758](https://github.com/kubernetes/kubernetes/pull/57758)
@@ -297,7 +297,7 @@ repository and in related repositories, such as
297
297
-->
298
298
{{< note >}}
299
299
确定要更改的正确源文件可能很棘手。在前面的示例中,官方的源文件位于 ` kubernetes/kubernetes `
300
- 代码仓库的 ` staging ` 目录中。但是根据您的情况 ,` staging ` 目录可能不是找到官方源文件的地方。
300
+ 代码仓库的 ` staging ` 目录中。但是根据你的情况 ,` staging ` 目录可能不是找到官方源文件的地方。
301
301
如果需要帮助,请阅读
302
302
[ kubernetes/kubernetes] ( https://github.com/kubernetes/kubernetes/tree/master/staging )
303
303
代码仓库和相关代码仓库
@@ -330,7 +330,7 @@ commit into the release-{{< skew prevMinorVersion >}} branch. The idea is to che
330
330
that edited `types.go`, but not the commit that has the results of running the scripts. For instructions, see
331
331
[Propose a Cherry Pick](https://git.k8s.io/community/contributors/devel/sig-release/cherry-picks.md).
332
332
-->
333
- 回想一下,您的 PR 有两个提交:一个用于编辑 ` types.go ` ,一个用于由脚本生成的文件。
333
+ 回想一下,你的 PR 有两个提交:一个用于编辑 ` types.go ` ,一个用于由脚本生成的文件。
334
334
下一步是将你的第一次提交 cherrypick 到 release-{{< skew prevMinorVersion >}} 分支。
335
335
这样做的原因是仅 cherrypick 编辑了 types.go 的提交,
336
336
而不是具有脚本运行结果的提交。
@@ -366,7 +366,7 @@ Now add a commit to your cherry-pick pull request that has the recently generate
366
366
and related files. Monitor your pull request until it gets merged into the
367
367
release-{{< skew prevMinorVersion >}} branch.
368
368
-->
369
- 现在将提交添加到您的 Cherry-Pick PR 中,该 PR 中包含最新生成的 OpenAPI 规范和相关文件。
369
+ 现在将提交添加到你的 Cherry-Pick PR 中,该 PR 中包含最新生成的 OpenAPI 规范和相关文件。
370
370
关注你的 PR,直到其合并到 release-{{< skew prevMinorVersion >}} 分支中为止。
371
371
372
372
<!--
@@ -405,7 +405,7 @@ the API reference documentation.
405
405
You are now ready to follow the [Generating Reference Documentation for the Kubernetes API](/docs/contribute/generate-ref-docs/kubernetes-api/) guide to generate the
406
406
[published Kubernetes API reference documentation](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/).
407
407
-->
408
- 现在,您可以按照
408
+ 现在,你可以按照
409
409
[ 生成 Kubernetes API 的参考文档] ( /zh/docs/contribute/generate-ref-docs/kubernetes-api/ )
410
410
指南来生成
411
411
[ 已发布的 Kubernetes API 参考文档] (/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)。
0 commit comments