Skip to content

Commit 1754a9e

Browse files
authored
Merge pull request #38869 from windsonsea/advancy
[zh] sync /contribute/advanced.md
2 parents 3a04079 + 746eb32 commit 1754a9e

File tree

1 file changed

+33
-21
lines changed

1 file changed

+33
-21
lines changed

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

Lines changed: 33 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,6 @@ This page assumes that you understand how to
2020
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
-->
23-
2423
如果你已经了解如何[贡献新内容](/zh-cn/docs/contribute/new-content/)
2524
[评阅他人工作](/zh-cn/docs/contribute/review/reviewing-prs/),并准备了解更多贡献的途径,
2625
请阅读此文。你需要使用 Git 命令行工具和其他工具做这些工作。
@@ -35,7 +34,7 @@ can propose improvements.
3534
-->
3635
## 提出改进建议 {#propose-improvements}
3736

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

4039
<!--
4140
After you've been contributing to the Kubernetes documentation for a while, you
@@ -78,7 +77,7 @@ can coordinate docs for a Kubernetes release.
7877
-->
7978
## 为 Kubernetes 版本发布协调文档工作 {#coordinate-docs-for-a-kubernetes-release}
8079

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

8483
<!--
@@ -111,7 +110,6 @@ The SIG Docs representative for a given release coordinates the following tasks:
111110
- Publish the documentation changes related to the release when the release
112111
artifacts are published.
113112
-->
114-
115113
SIG Docs 团队的代表需要为一个指定的版本协调以下工作:
116114

117115
- 通过特性跟踪表来监视新功能特性或现有功能特性的修改。
@@ -140,10 +138,9 @@ few PR submissions.
140138
141139
Responsibilities for New Contributor Ambassadors include:
142140
-->
143-
144141
## 担任新的贡献者大使 {#serve-as-a-new-contributor-ambassador}
145142

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

149146
新的贡献者大使欢迎 SIG-Docs 的新贡献者,对新贡献者的 PR 提出建议,
@@ -152,15 +149,15 @@ SIG Docs [批准人(Approvers)](/zh-cn/docs/contribute/participate/roles-and
152149
新的贡献者大使的职责包括:
153150

154151
<!--
155-
- Being available on the [Kubernetes #sig-docs channel](https://kubernetes.slack.com) to answer questions from new contributors.
152+
- Monitoring the [#sig-docs Slack channel](https://kubernetes.slack.com) for questions from new contributors.
156153
- Working with PR wranglers to identify [good first issues](https://kubernetes.dev/docs/guide/help-wanted/#good-first-issue) for new contributors.
157154
- Mentoring new contributors through their first few PRs to the docs repo.
158155
- Helping new contributors create the more complex PRs they need to become Kubernetes members.
159156
- [Sponsoring contributors](/docs/contribute/advanced/#sponsor-a-new-contributor) on their path to becoming Kubernetes members.
160157
- Hosting a monthly meeting to help and mentor new contributors.
161158
-->
162159
- 监听 [Kubernetes #sig-docs 频道](https://kubernetes.slack.com) 上新贡献者的 Issue。
163-
- 与 PR 管理者合作为新参与者寻找[合适的第一个 issues](https://kubernetes.dev/docs/guide/help-wanted/#good-first-issue)
160+
- 与 PR 管理者合作为新参与者寻找[合适的第一个 issue](https://kubernetes.dev/docs/guide/help-wanted/#good-first-issue)
164161
- 通过前几个 PR 指导新贡献者为文档存储库作贡献。
165162
- 帮助新的贡献者创建成为 Kubernetes 成员所需的更复杂的 PR。
166163
- [为贡献者提供保荐](#sponsor-a-new-contributor),使其成为 Kubernetes 成员。
@@ -179,7 +176,7 @@ can sponsor new contributors.
179176
-->
180177
## 为新的贡献者提供保荐 {#sponsor-a-new-contributor}
181178

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

185182
<!--
@@ -217,7 +214,7 @@ can serve a term as a co-chair of SIG Docs.
217214
-->
218215
## 担任 SIG 联合主席 {#sponsor-a-new-contributor}
219216

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

223220
### 前提条件 {#prerequisites}
@@ -228,10 +225,10 @@ A Kubernetes member must meet the following requirements to be a co-chair:
228225
- Understand SIG Docs workflows and tooling: git, Hugo, localization, blog subproject
229226
- Understand how other Kubernetes SIGs and repositories affect the SIG Docs
230227
workflow, including:
231-
[teams in k/org](https://github.com/kubernetes/org/blob/main/config/kubernetes/sig-docs/teams.yaml), the
232-
[process in k/community](https://github.com/kubernetes/community/tree/main/sig-docs),
228+
[teams in k/org](https://github.com/kubernetes/org/blob/master/config/kubernetes/sig-docs/teams.yaml), the
229+
[process in k/community](https://github.com/kubernetes/community/tree/master/sig-docs),
233230
plugins in [k/test-infra](https://github.com/kubernetes/test-infra/), and the role of
234-
[SIG Architecture](https://github.com/kubernetes/community/tree/main/sig-architecture).
231+
[SIG Architecture](https://github.com/kubernetes/community/tree/master/sig-architecture).
235232
In addition, understand how the [Kubernetes docs release process](/docs/contribute/advanced/#coordinate-docs-for-a-kubernetes-release) works.
236233
- Approved by the SIG Docs community either directly or via lazy consensus.
237234
- Commit at least 5 hours per week (and often more) to the role for a minimum of 6 months
@@ -240,8 +237,8 @@ Kubernetes 成员必须满足以下要求才能成为联合主席:
240237

241238
- 理解 SIG Docs 工作流程和工具:git、Hugo、本地化、博客子项目
242239
- 理解其他 Kubernetes SIG 和仓库会如何影响 SIG Docs 工作流程,包括:
243-
[k/org 中的团队](https://github.com/kubernetes/org/blob/main/config/kubernetes/sig-docs/teams.yaml)
244-
[k/community 中的流程](https://github.com/kubernetes/community/tree/main/sig-docs)
240+
[k/org 中的团队](https://github.com/kubernetes/org/blob/master/config/kubernetes/sig-docs/teams.yaml)
241+
[k/community 中的流程](https://github.com/kubernetes/community/tree/master/sig-docs)
245242
[k/test-infra](https://github.com/kubernetes/test-infra/) 中的插件、
246243
[SIG Architecture](https://github.com/kubernetes/community/tree/main/sig-architecture) 中的角色。
247244
此外,了解 [Kubernetes 文档发布流程](/zh-cn/docs/contribute/advanced/#coordinate-docs-for-a-kubernetes-release)的工作原理。
@@ -251,14 +248,21 @@ Kubernetes 成员必须满足以下要求才能成为联合主席:
251248
<!--
252249
### Responsibilities
253250
254-
The role of co-chair is primarily one of service: co-chairs handle process and policy, schedule and run meetings, schedule PR wranglers, and generally do the things that no one else wants to do in order to build contributor capacity.
251+
The role of co-chair is one of service: co-chairs build contributor capacity, handle process and policy, schedule and run meetings, schedule PR wranglers, advocate for docs in the Kubernetes community, make sure that docs succeed in Kubernetes release cycles, and keep SIG Docs focused on effective priorities.
255252
256253
Responsibilities include:
257254
-->
258255
### 职责范围 {#responsibilities}
259256

260-
联合主席主要提供以下服务:
261-
联合主席负责处理流程和政策、时间安排和召开会议、安排 PR 管理员、以及一些其他人不想做的事情,目的是增长贡献者团队。
257+
联合主席的角色提供以下服务:
258+
259+
- 拓展贡献者规模
260+
- 处理流程和政策
261+
- 安排时间和召开会议
262+
- 安排 PR 管理员
263+
- 在 Kubernetes 社区中提出文档倡议
264+
- 确保文档在 Kubernetes 发布周期中符合预期
265+
- 让 SIG Docs 专注于有效的优先事项
262266

263267
职责范围包括:
264268

@@ -354,17 +358,17 @@ Begin and end meetings on time.
354358
<!--
355359
**Use Zoom effectively**:
356360
357-
- Familiarize yourself with [Zoom guidelines for Kubernetes](https://github.com/kubernetes/community/blob/main/communication/zoom-guidelines.md)
361+
- Familiarize yourself with [Zoom guidelines for Kubernetes](https://github.com/kubernetes/community/blob/master/communication/zoom-guidelines.md)
358362
- Claim the host role when you log in by entering the host key
359363
360364
<img src="/images/docs/contribute/claim-host.png" width="75%" alt="Claiming the host role in Zoom" />
361365
-->
362366
**有效利用 Zoom**
363367

364-
- 熟悉 [ Kubernetes Zoom 指南](https://github.com/kubernetes/community/blob/main/communication/zoom-guidelines.md)
368+
- 熟悉 [Kubernetes Zoom 指南](https://github.com/kubernetes/community/blob/master/communication/zoom-guidelines.md)
365369
- 输入主持人密钥登录时声明主持人角色
366370

367-
<img src="/images/docs/contribute/claim-host.png" width="75%" alt="声明 Zoom 角色" />
371+
<img src="/images/docs/contribute/claim-host.png" width="75%" alt="声明 Zoom 主持人角色" />
368372

369373
<!--
370374
### Recording meetings on Zoom
@@ -383,3 +387,11 @@ The video uploads automatically to YouTube.
383387

384388
视频会自动上传到 YouTube。
385389

390+
<!--
391+
### Offboarding a SIG Co-chair (Emeritus)
392+
393+
See: [k/community/sig-docs/offboarding.md](https://github.com/kubernetes/community/blob/master/sig-docs/offboarding.md)
394+
-->
395+
### SIG 联合主席 (Emeritus) 离职 {#offboarding-a-sig-cochair}
396+
397+
参见 [k/community/sig-docs/offboarding.md](https://github.com/kubernetes/community/blob/master/sig-docs/offboarding.md)

0 commit comments

Comments
 (0)