Skip to content

Commit 34375de

Browse files
committed
[zh] Fix links for contribute
1 parent 3332857 commit 34375de

File tree

5 files changed

+111
-99
lines changed

5 files changed

+111
-99
lines changed

content/zh-cn/docs/contribute/_index.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Kubernetes documentation contributors:
6161
- Translate the documentation
6262
- Manage and publish the documentation parts of the Kubernetes release cycle
6363
-->
64-
本网站由 [Kubernetes SIG(特别兴趣小组)Docs](/zh/docs/contribute/#get-involved-with-SIG-Docs) 维护。
64+
本网站由 [Kubernetes SIG Docs](/zh-cn/docs/contribute/#get-involved-with-SIG-Docs)(文档特别兴趣小组)维护。
6565

6666
Kubernetes 文档项目的贡献者:
6767

@@ -103,7 +103,7 @@ To get involved with documentation:
103103

104104
1. 签署 CNCF 的[贡献者许可协议](https://github.com/kubernetes/community/blob/master/CLA.md)
105105
2. 熟悉[文档仓库](https://github.com/kubernetes/website)和网站的[静态站点生成器](https://gohugo.io)
106-
3. 确保理解[发起 PR](/zh/docs/contribute/new-content/open-a-pr/)[审查变更](/zh/docs/contribute/review/reviewing-prs/)的基本流程。
106+
3. 确保理解[发起 PR](/zh-cn/docs/contribute/new-content/open-a-pr/)[审查变更](/zh-cn/docs/contribute/review/reviewing-prs/)的基本流程。
107107

108108
<!-- See https://github.com/kubernetes/website/issues/28808 for live-editor URL to this figure -->
109109
<!-- You can also cut/paste the mermaid code into the live editor at https://mermaid-js.github.io/mermaid-live-editor to play around with it -->
@@ -157,9 +157,9 @@ Figure 1 outlines a roadmap for new contributors. You can follow some or all of
157157
图 1. 新手入门指示。
158158

159159
图 1 概述了新贡献者的路线图。
160-
你可以遵从`注册``评审`所述的某些或全部步骤。
160+
你可以遵从“注册”和“评审”所述的某些或全部步骤。
161161
至此,你完成了发起 PR 的准备工作,
162-
可以通过`发起 PR`列出的事项实现你的贡献目标。
162+
可以通过发起 PR列出的事项实现你的贡献目标。
163163
再次重申,欢迎随时提出问题!
164164

165165
<!--
@@ -168,7 +168,7 @@ See [Participating in SIG Docs](/docs/contribute/participate/) for more details
168168
roles and permissions.
169169
-->
170170
有些任务要求 Kubernetes 组织内更高的信任级别和访问权限。
171-
阅读[参与 SIG Docs 工作](/zh/docs/contribute/participate/) ,获取角色和权限的更多细节。
171+
阅读[参与 SIG Docs 工作](/zh-cn/docs/contribute/participate/),获取角色和权限的更多细节。
172172

173173
<!--
174174
## Your first contribution
@@ -229,17 +229,17 @@ Figure 2. Preparation for your first contribution.
229229
- Learn about [page content types](/docs/contribute/style/page-content-types/)
230230
and [Hugo shortcodes](/docs/contribute/style/hugo-shortcodes/).
231231
-->
232-
- 通读[贡献概述](/zh/docs/contribute/new-content/overview/),了解参与贡献的不同方式。
233-
- 查看 [`kubernetes/website` 问题列表](https://github.com/kubernetes/website/issues/)
234-
检索最适合作为切入点的问题。
235-
- 在现有文档上,[使用 GitHub 提交 PR](/zh/docs/contribute/new-content/open-a-pr/#changes-using-github)
232+
- 通读[贡献概述](/zh-cn/docs/contribute/new-content/),了解参与贡献的不同方式。
233+
- 查看 [`kubernetes/website` 问题列表](https://github.com/kubernetes/website/issues/)
234+
检索最适合作为切入点的问题。
235+
- 在现有文档上,[使用 GitHub 提交 PR](/zh-cn/docs/contribute/new-content/open-a-pr/#changes-using-github)
236236
掌握在 GitHub 上登记 Issue 的方法。
237-
- Kubernetes 社区其他成员会[评审 PR ](/zh/docs/contribute/review/reviewing-prs/)
237+
- Kubernetes 社区其他成员会[评审 PR ](/zh-cn/docs/contribute/review/reviewing-prs/)
238238
以确保文档精准和语言流畅。
239-
- 阅读 kubernetes 的[内容指南](/zh/docs/contribute/style/content-guide/)
240-
[风格指南](/zh/docs/contribute/style/style-guide/),以发表有见地的评论。
241-
- 了解[页面内容类型](/zh/docs/contribute/style/page-content-types/)
242-
[Hugo 短代码](/zh/docs/contribute/style/hugo-shortcodes/)
239+
- 阅读 kubernetes 的[内容指南](/zh-cn/docs/contribute/style/content-guide/)
240+
[风格指南](/zh-cn/docs/contribute/style/style-guide/),以发表有见地的评论。
241+
- 了解[页面内容类型](/zh-cn/docs/contribute/style/page-content-types/)
242+
[Hugo 短代码](/zh-cn/docs/contribute/style/hugo-shortcodes/)
243243

244244
<!--
245245
## Next steps
@@ -254,11 +254,11 @@ Figure 2. Preparation for your first contribution.
254254
-->
255255
## 下一步 {#next-teps}
256256

257-
- 学习在仓库的[本地克隆中工作](/zh/docs/contribute/new-content/open-a-pr/#fork-the-repo)
258-
-[发行版的特性](/zh/docs/contribute/new-content/new-features/)编写文档。
259-
- 加入 [SIG Docs](/zh/docs/contribute/participate/),并成为[成员或评审者](/zh/docs/contribute/participate/roles-and-responsibilities/)
257+
- 学习在仓库的[本地克隆中工作](/zh-cn/docs/contribute/new-content/open-a-pr/#fork-the-repo)
258+
-[发行版的特性](/zh-cn/docs/contribute/new-content/new-features/)编写文档。
259+
- 加入 [SIG Docs](/zh-cn/docs/contribute/participate/),并成为[成员或评审者](/zh-cn/docs/contribute/participate/roles-and-responsibilities/)
260260

261-
- 开始或帮助[本地化](/zh/docs/contribute/localization/) 工作。
261+
- 开始或帮助[本地化](/zh-cn/docs/contribute/localization/) 工作。
262262

263263
<!--
264264
## Get involved with SIG Docs
@@ -272,7 +272,7 @@ SIG Docs communicates with different methods:
272272
-->
273273
## 参与 SIG Docs 工作 {#get-involved-with-SIG-Docs}
274274

275-
[SIG Docs](/zh/docs/contribute/participate/) 是负责发布、维护 Kubernetes 文档的贡献者团体。
275+
[SIG Docs](/zh-cn/docs/contribute/participate/) 是负责发布、维护 Kubernetes 文档的贡献者团体。
276276
参与 SIG Docs 是 Kubernetes 贡献者(开发者和其他人员)对 Kubernetes 项目产生重大影响力的好方式。
277277

278278
SIG Docs 的几种沟通方式:
@@ -306,10 +306,10 @@ SIG Docs 的几种沟通方式:
306306
-->
307307
## 其他贡献方式 {#other-ways-to-contribute}
308308

309-
- 访问 [Kubernetes 社区网站](/zh/community/)
309+
- 访问 [Kubernetes 社区网站](/zh-cn/community/)
310310
参与 Twitter 或 Stack Overflow,了解当地的 Kubernetes 会议和活动等等。
311311
- 阅读[贡献者备忘单](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet)
312312
参与 Kubernetes 功能开发。
313313
- 访问贡献者网站,进一步了解有关 [Kubernetes 贡献者](https://www.kubernetes.dev/)
314314
[更多贡献者资源](https://www.kubernetes.dev/resources/)的信息。
315-
- 提交一篇[博客文章或案例研究](/zh/docs/contribute/new-content/blogs-case-studies/)
315+
- 提交一篇[博客文章或案例研究](/zh-cn/docs/contribute/new-content/blogs-case-studies/)

content/zh-cn/docs/contribute/advanced.md

Lines changed: 51 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -21,20 +21,21 @@ to learn about more ways to contribute. You need to use the Git command line
2121
client and other tools for some of these tasks.
2222
-->
2323

24-
如果你已经了解如何[贡献新内容](/zh/docs/contribute/new-content/overview/)
25-
[评阅他人工作](/zh/docs/contribute/review/reviewing-prs/),并准备了解更多贡献的途径,
24+
如果你已经了解如何[贡献新内容](/zh-cn/docs/contribute/new-content/)
25+
[评阅他人工作](/zh-cn/docs/contribute/review/reviewing-prs/),并准备了解更多贡献的途径,
2626
请阅读此文。你需要使用 Git 命令行工具和其他工具做这些工作。
2727

2828
<!-- body -->
2929

3030
<!--
3131
## Propose improvements
3232
33-
SIG Docs [members](/docs/contribute/participate/roles-and-responsibilities/#members) can propose improvements.
33+
SIG Docs [members](/docs/contribute/participate/roles-and-responsibilities/#members)
34+
can propose improvements.
3435
-->
35-
## 提出改进建议
36+
## 提出改进建议 {#propose-improvements}
3637

37-
SIG Docs 的 [成员](/zh/docs/contribute/participate/roles-and-responsibilities/#members) 可以提出改进建议。
38+
SIG Docs 的[成员](/zh-cn/docs/contribute/participate/roles-and-responsibilities/#members) 可以提出改进建议。
3839

3940
<!--
4041
After you've been contributing to the Kubernetes documentation for a while, you
@@ -50,8 +51,8 @@ changes. The quickest way to get answers to questions about how the documentatio
5051
currently works is to ask in the `#sig-docs` Slack channel on
5152
[kubernetes.slack.com](https://kubernetes.slack.com)
5253
-->
53-
在对 Kubernetes 文档贡献了一段时间后,你可能会对[样式指南](/zh/docs/contribute/style/style-guide/)
54-
[内容指南](/zh/docs/contribute/style/content-guide/)、用于构建文档的工具链、网站样式、
54+
在对 Kubernetes 文档贡献了一段时间后,你可能会对[样式指南](/zh-cn/docs/contribute/style/style-guide/)
55+
[内容指南](/zh-cn/docs/contribute/style/content-guide/)、用于构建文档的工具链、网站样式、
5556
评审和合并 PR 的流程或者文档的其他方面产生改进的想法。
5657
为了尽可能透明化,这些提议都需要在 SIG Docs 会议或
5758
[kubernetes-sig-docs 邮件列表](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)上讨论。
@@ -66,18 +67,19 @@ appropriate. For instance, an update to the style guide or the website's
6667
functionality might involve opening a pull request, while a change related to
6768
documentation testing might involve working with sig-testing.
6869
-->
69-
在进行了讨论并且 SIG 就期望的结果达成一致之后,你就能以最合理的方式处理改进建议了。例如,样式指南或网站功能的更新可能涉及 PR 的新增,而与文档测试相关的更改可能涉及 sig-testing。
70+
在进行了讨论并且 SIG 就期望的结果达成一致之后,你就能以最合理的方式处理改进建议了。
71+
例如,样式指南或网站功能的更新可能涉及 PR 的新增,而与文档测试相关的更改可能涉及 sig-testing。
7072

7173
<!--
7274
## Coordinate docs for a Kubernetes release
7375
74-
SIG Docs [approvers](/docs/contribute/participating/#approvers) can coordinate
75-
docs for a Kubernetes release.
76+
SIG Docs [approvers](/docs/contribute/participate/roles-and-responsibilities/#approvers)
77+
can coordinate docs for a Kubernetes release.
7678
-->
77-
## 为 Kubernetes 版本发布协调文档工作
79+
## 为 Kubernetes 版本发布协调文档工作 {#coordinate-docs-for-a-kubernetes-release}
7880

79-
SIG Docs 的[批准者(approvers)](/zh/docs/contribute/participating/#approvers) 可以为
80-
Kubernetes 版本发布协调文档工作。
81+
SIG Docs 的[批准者(approvers)](/zh-cn/docs/contribute/participate/roles-and-responsibilities/#approvers)
82+
可以为 Kubernetes 版本发布协调文档工作。
8183

8284
<!--
8385
Each Kubernetes release is coordinated by a team of people participating in the
@@ -129,37 +131,37 @@ rotated among SIG Docs approvers.
129131
<!--
130132
## Serve as a New Contributor Ambassador
131133
132-
SIG Docs [approvers](/docs/contribute/participating/#approvers) can serve as
133-
New Contributor Ambassadors.
134+
SIG Docs [approvers](/docs/contribute/participate/roles-and-responsibilities/#approvers)
135+
can serve as New Contributor Ambassadors.
134136
135-
New Contributor Ambassadors work together to welcome new contributors to SIG-Docs,
137+
New Contributor Ambassadors welcome new contributors to SIG-Docs,
136138
suggest PRs to new contributors, and mentor new contributors through their first
137139
few PR submissions.
138140
139141
Responsibilities for New Contributor Ambassadors include:
140142
-->
141143

142-
## 担任新的贡献者大使
144+
## 担任新的贡献者大使 {#serve-as-a-new-contributor-ambassador}
143145

144-
SIG Docs [批准人(Approvers)](/zh/docs/contribute/participating/#approvers)
146+
SIG Docs [批准人(Approvers)](/zh-cn/docs/contribute/participate/roles-and-responsibilities/#approvers)
145147
可以担任新的贡献者大使。
146148

147-
新的贡献者大使共同努力欢迎 SIG-Docs 的新贡献者,对新贡献者的 PR 提出建议,
149+
新的贡献者大使欢迎 SIG-Docs 的新贡献者,对新贡献者的 PR 提出建议,
148150
以及在前几份 PR 提交中指导新贡献者。
149151

150152
新的贡献者大使的职责包括:
151153

152154
<!--
153155
- Being available on the [Kubernetes #sig-docs channel](https://kubernetes.slack.com) to answer questions from new contributors.
154-
- Working with PR wranglers to identify [good first issues](https://kubernetes.dev/docs/guide/help-wanted/#good-first-issue) for new contributors.
155-
- Mentoring new contributors through their first few PRs to the docs repo.
156+
- Working with PR wranglers to identify [good first issues](https://kubernetes.dev/docs/guide/help-wanted/#good-first-issue) for new contributors.
157+
- Mentoring new contributors through their first few PRs to the docs repo.
156158
- Helping new contributors create the more complex PRs they need to become Kubernetes members.
157-
-[Sponsoring contributors](/docs/contribute/advanced/#sponsor-a-new-contributor) on their path to becoming Kubernetes members.
159+
- [Sponsoring contributors](/docs/contribute/advanced/#sponsor-a-new-contributor) on their path to becoming Kubernetes members.
158160
- Hosting a monthly meeting to help and mentor new contributors.
159161
-->
160162
- 监听 [Kubernetes #sig-docs 频道](https://kubernetes.slack.com) 上新贡献者的 Issue。
161-
- 与 PR 管理者合作为新参与者寻找[合适的第一个 issues](https://kubernetes.dev/docs/guide/help-wanted/#good-first-issue)
162-
- 通过前几个 PR 指导新贡献者为文档存储库作贡献。
163+
- 与 PR 管理者合作为新参与者寻找[合适的第一个 issues](https://kubernetes.dev/docs/guide/help-wanted/#good-first-issue)
164+
- 通过前几个 PR 指导新贡献者为文档存储库作贡献。
163165
- 帮助新的贡献者创建成为 Kubernetes 成员所需的更复杂的 PR。
164166
- [为贡献者提供保荐](#sponsor-a-new-contributor),使其成为 Kubernetes 成员。
165167
- 每月召开一次会议,帮助和指导新的贡献者。
@@ -172,22 +174,23 @@ Current New Contributor Ambassadors are announced at each SIG-Docs meeting and i
172174
<!--
173175
## Sponsor a new contributor
174176
175-
SIG Docs [reviewers](/docs/contribute/participating/#reviewers) can sponsor
176-
new contributors.
177+
SIG Docs [reviewers](/docs/contribute/participate/roles-and-responsibilities/#reviewers)
178+
can sponsor new contributors.
177179
-->
178180
## 为新的贡献者提供保荐 {#sponsor-a-new-contributor}
179181

180-
SIG Docs 的[评审人(Reviewers)](/zh/docs/contribute/participating/#reviewers) 可以为新的贡献者提供保荐。
182+
SIG Docs 的[评审人(Reviewers)](/zh-cn/docs/contribute/participate/roles-and-responsibilities/#reviewers)
183+
可以为新的贡献者提供保荐。
181184

182185
<!--
183186
After a new contributor has successfully submitted 5 substantive pull requests
184187
to one or more Kubernetes repositories, they are eligible to apply for
185-
[membership](/docs/contribute/participating#members) in the Kubernetes
186-
organization. The contributor's membership needs to be backed by two sponsors
187-
who are already reviewers.
188+
[membership](/docs/contribute/participate/roles-and-responsibilities/#members)
189+
in the Kubernetes organization. The contributor's membership needs to be
190+
backed by two sponsors who are already reviewers.
188191
-->
189192
新的贡献者针对一个或多个 Kubernetes 项目仓库成功提交了 5 个实质性 PR 之后,
190-
就有资格申请 Kubernetes 组织的[成员身份](/zh/docs/contribute/participate/roles-and-responsibilities/#members)
193+
就有资格申请 Kubernetes 组织的[成员身份](/zh-cn/docs/contribute/participate/roles-and-responsibilities/#members)
191194
贡献者的成员资格需要同时得到两位评审人的保荐。
192195

193196
<!--
@@ -212,18 +215,23 @@ can serve a term as a co-chair of SIG Docs.
212215
213216
### Prerequisites
214217
-->
215-
## 担任 SIG 联合主席
218+
## 担任 SIG 联合主席 {#sponsor-a-new-contributor}
216219

217-
SIG Docs [成员(Members)](/zh/docs/contribute/participate/roles-and-responsibilities/#members)
220+
SIG Docs [成员(Members)](/zh-cn/docs/contribute/participate/roles-and-responsibilities/#members)
218221
可以担任 SIG Docs 的联合主席。
219222

220-
### 前提条件
223+
### 前提条件 {#prerequisites}
221224

222225
<!--
223226
A Kubernetes member must meet the following requirements to be a co-chair:
224227
225228
- Understand SIG Docs workflows and tooling: git, Hugo, localization, blog subproject
226-
- Understand how other Kubernetes SIGs and repositories affect the SIG Docs workflow, including: [teams in k/org](https://github.com/kubernetes/org/blob/master/config/kubernetes/sig-docs/teams.yaml), the [process in k/community](https://github.com/kubernetes/community/tree/master/sig-docs), plugins in [k/test-infra](https://github.com/kubernetes/test-infra/), and the role of [SIG Architecture](https://github.com/kubernetes/community/tree/master/sig-architecture).
229+
- Understand how other Kubernetes SIGs and repositories affect the SIG Docs
230+
workflow, including:
231+
[teams in k/org](https://github.com/kubernetes/org/blob/master/config/kubernetes/sig-docs/teams.yaml), the
232+
[process in k/community](https://github.com/kubernetes/community/tree/master/sig-docs),
233+
plugins in [k/test-infra](https://github.com/kubernetes/test-infra/), and the role of
234+
[SIG Architecture](https://github.com/kubernetes/community/tree/master/sig-architecture).
227235
In addition, understand how the [Kubernetes docs release process](/docs/contribute/advanced/#coordinate-docs-for-a-kubernetes-release) works.
228236
- Approved by the SIG Docs community either directly or via lazy consensus.
229237
- Commit at least 5 hours per week (and often more) to the role for a minimum of 6 months
@@ -235,8 +243,8 @@ Kubernetes 成员必须满足以下要求才能成为联合主席:
235243
[k/org 中的团队](https://github.com/kubernetes/org/blob/master/config/kubernetes/sig-docs/teams.yaml)
236244
[k/community 中的流程](https://github.com/kubernetes/community/tree/master/sig-docs)
237245
[k/test-infra](https://github.com/kubernetes/test-infra/) 中的插件、
238-
[SIG Architecture](https://github.com/kubernetes/community/tree/master/sig-architecture) 中的角色。
239-
此外,了解 [Kubernetes 文档发布流程](/docs/contribute/advanced/#coordinate-docs-for-a-kubernetes-release) 的工作原理。
246+
[SIG Architecture](https://github.com/kubernetes/community/tree/master/sig-architecture) 中的角色。
247+
此外,了解 [Kubernetes 文档发布流程](/zh-cn/docs/contribute/advanced/#coordinate-docs-for-a-kubernetes-release)的工作原理。
240248
- 由 SIG Docs 社区直接或通过惰性共识批准。
241249
- 在至少 6 个月的时段内,确保每周至少投入 5 个小时(通常更多)
242250

@@ -247,7 +255,7 @@ The role of co-chair is primarily one of service: co-chairs handle process and p
247255
248256
Responsibilities include:
249257
-->
250-
### 职责范围
258+
### 职责范围 {#responsibilities}
251259

252260
联合主席主要提供以下服务:
253261
联合主席负责处理流程和政策、时间安排和召开会议、安排 PR 管理员、以及一些其他人不想做的事情,目的是增长贡献者团队。
@@ -282,7 +290,7 @@ To schedule and run effective meetings, these guidelines show what to do, how to
282290
283291
- Hold respectful, inclusive discussions with respectful, inclusive language.
284292
-->
285-
### 召开高效的会议
293+
### 召开高效的会议 {#running-effective-meetings}
286294

287295
为了安排和召开高效的会议,这些指南说明了如何做、怎样做以及原因。
288296

@@ -332,7 +340,7 @@ For weekly meetings, copypaste the previous week's notes into the "Past meetings
332340
333341
**Honor folks' time**:
334342
335-
- Begin and end meetings punctually
343+
Begin and end meetings on time.
336344
-->
337345
**根据需要来进行协调**
338346

@@ -341,7 +349,7 @@ For weekly meetings, copypaste the previous week's notes into the "Past meetings
341349

342350
**尊重大家的时间**:
343351

344-
- 准时开始和结束会议
352+
按时开始和结束会议
345353

346354
<!--
347355
**Use Zoom effectively**:
@@ -362,12 +370,12 @@ For weekly meetings, copypaste the previous week's notes into the "Past meetings
362370
### Recording meetings on Zoom
363371
364372
When you're ready to start the recording, click Record to Cloud.
365-
373+
366374
When you're ready to stop recording, click Stop.
367375
368376
The video uploads automatically to YouTube.
369377
-->
370-
### 录制 Zoom 会议
378+
### 录制 Zoom 会议 {#recording-meetings-on-zoom}
371379

372380
准备开始录制时,请单击“录制到云”。
373381

0 commit comments

Comments
 (0)