Merge pull request #33677 from windsonsea/patch-1

[zh] updated two files in content/zh/docs/contribute/

content/zh/docs/contribute/_index.md

@@ -8,7 +8,7 @@ weight: 80
 card:
   name: contribute
   weight: 10
-  title: 开始贡献
+  title: 开始为 Kubernetes 做贡献
 ---
 <!--
 ---
@@ -21,7 +21,7 @@ weight: 80
 card:
   name: contribute
   weight: 10
-  title: Start contributing
+  title: Start contributing to K8s
 ---
 -->
 
@@ -40,8 +40,9 @@ To learn more about contributing to Kubernetes in general, see the
 -->
 {{< note >}}
 要了解有关为 Kubernetes 做出贡献的更多信息，请参阅
-[贡献者文档](https://www.kubernetes.dev/docs/).
+[贡献者文档](https://www.kubernetes.dev/docs/)。
 {{< /note >}}
+
 <!--
 This website is maintained by [Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs).
 
@@ -51,21 +52,16 @@ Kubernetes documentation contributors:
 - Create new content
 - Translate the documentation
 - Manage and publish the documentation parts of the Kubernetes release cycle
-
-Kubernetes documentation welcomes improvements from all contributors, new and experienced!
 -->
+本网站由 [Kubernetes SIG（特别兴趣小组）Docs](/zh/docs/contribute/#get-involved-with-SIG-Docs) 维护。
 
-本网站由 [Kubernetes SIG（特别兴趣小组） Docs](/zh/docs/contribute/#get-involved-with-SIG-Docs) 维护。
-
-Kubernetes 文档项目的贡献者:
+Kubernetes 文档项目的贡献者：
 
 - 改进现有内容
 - 创建新内容
 - 翻译文档
 - 管理并发布 Kubernetes 周期性发行版的文档
 
-Kubernetes 文档欢迎来自各方贡献者的改进，无论新手还是高手！
-
 <!-- body -->
 
 <!-- 
@@ -78,42 +74,140 @@ You need to be comfortable with
 [git](https://git-scm.com/) and
 [GitHub](https://lab.github.com/)
 to work effectively in the Kubernetes community.
-
 -->
 ## 入门 {#getting-started}
 
 任何人都可以提出文档方面的问题（issue），或贡献一个变更，用拉取请求（PR）的方式提交到
 [GitHub 上的 `kubernetes/website` 仓库](https://github.com/kubernetes/website)。
 当然你需要熟练使用 [git](https://git-scm.com/) 和 [GitHub](https://lab.github.com/) 才能在 Kubernetes 社区中有效工作。
+
 <!-- 
 To get involved with documentation:
 
 1. Sign the CNCF [Contributor License Agreement](https://github.com/kubernetes/community/blob/master/CLA.md).
-1. Familiarize yourself with the [documentation repository](https://github.com/kubernetes/website)
+2. Familiarize yourself with the [documentation repository](https://github.com/kubernetes/website)
    and the website's [static site generator](https://gohugo.io).
-1. Make sure you understand the basic processes for
+3. Make sure you understand the basic processes for
    [opening a pull request](/docs/contribute/new-content/open-a-pr/) and
    [reviewing changes](/docs/contribute/review/reviewing-prs/).
+-->
+如何参与文档编制：
+
+1. 签署 CNCF 的[贡献者许可协议](https://github.com/kubernetes/community/blob/master/CLA.md)。
+2. 熟悉[文档仓库](https://github.com/kubernetes/website)和网站的[静态站点生成器](https://gohugo.io)。
+3. 确保理解[发起 PR](/zh/docs/contribute/new-content/open-a-pr/) 和[审查变更](/zh/docs/contribute/review/reviewing-prs/)的基本流程。
+
+<!-- See https://github.com/kubernetes/website/issues/28808 for live-editor URL to this figure -->
+<!-- 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 -->
+
+{{< mermaid >}}
+flowchart TB
+subgraph third[发起 PR]
+direction TB
+U[ ] -.-
+Q[改进现有内容] --- N[创建新内容]
+N --- O[翻译文档]
+O --- P[管理并发布 K8s<br>周期性发行版的文档]
+
+end
+
+subgraph second[评审]
+direction TB
+   T[ ] -.-
+   D[仔细查看<br>K8s/website<br>仓库] --- E[下载安装 Hugo<br>静态站点<br>生成器]
+   E --- F[了解基本的<br>GitHub 命令]
+   F --- G[评审待处理的 PR<br>并遵从变更审查<br>流程]
+end
+
+subgraph first[注册]
+    direction TB
+    S[ ] -.-
+    B[签署 CNCF<br>贡献者<br>许可协议] --- C[加入 sig-docs<br>Slack 频道] 
+    C --- V[加入 kubernetes-sig-docs<br>邮件列表]
+    V --- M[参加每周的<br>sig-docs 电话会议<br>或 slack 会议]
+end
+
+A([fa:fa-user 新的<br>贡献者]) --> first
+A --> second
+A --> third
+A --> H[提出问题!!!]
+
+
+classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px;
+classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold
+classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000
+class A,B,C,D,E,F,G,H,M,Q,N,O,P,V grey
+class S,T,U spacewhite
+class first,second,third white
+{{</ mermaid >}}
+
+<!-- 
+Figure 1. Getting started for a new contributor.
 
+Figure 1 outlines a roadmap for new contributors. You can follow some or all of the steps for `Sign up` and `Review`. Now you are ready to open PRs that achieve your contribution objectives with some listed under `Open PR`. Again, questions are always welcome!
+-->
+图 1. 新手入门指示。
+
+图 1 概述了新贡献者的路线图。
+你可以遵从`注册`和`评审`所述的某些或全部步骤。
+至此，你完成了发起 PR 的准备工作，
+可以通过`发起 PR`列出的事项实现你的贡献目标。
+再次重申，欢迎随时提出问题！
+
+<!-- 
 Some tasks require more trust and more access in the Kubernetes organization.
 See [Participating in SIG Docs](/docs/contribute/participate/) for more details about
 roles and permissions.
 -->
-如何参与文档编制:
-
-1. 签署 CNCF 的[贡献者许可协议](https://github.com/kubernetes/community/blob/master/CLA.md)。
-2. 熟悉[文档仓库](https://github.com/kubernetes/website)
-   和网站的[静态站点生成器](https://gohugo.io)。
-3. 确保理解
-   [发起 PR](/zh/docs/contribute/new-content/open-a-pr/) 和
-   [审查变更](/zh/docs/contribute/review/reviewing-prs/)的基本流程。
-
 有些任务要求 Kubernetes 组织内更高的信任级别和访问权限。
 阅读[参与 SIG Docs 工作](/zh/docs/contribute/participate/) ，获取角色和权限的更多细节。
 
-<!--
+<!-- 
 ## Your first contribution
 
+You can prepare for your first contribution by reviewing several steps beforehand. Figure 2 outlines the steps and the details follow. 
+-->
+## 第一次贡献 {#your-first-contribution}
+
+你可以提前查阅几个步骤，来准备你的第一次贡献。
+图 2 概述了后续的步骤和细节。
+
+<!-- See https://github.com/kubernetes/website/issues/28808 for live-editor URL to this figure -->
+<!-- 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 -->
+
+{{< mermaid >}}
+flowchart LR
+    subgraph second[第一次贡献]
+    direction TB
+    S[ ] -.-
+    G[查阅其他 K8s<br>成员发起的 PR] -->
+    A[检索 K8s/website<br>问题列表是否有<br>good first 一类的 PR] --> B[发起一个 PR!!]
+    end
+    subgraph first[建议的准备工作]
+    direction TB
+       T[ ] -.-
+       D[阅读贡献概述] -->E[阅读 K8s 内容<br>和风格指南]
+       E --> F[了解 Hugo 页面<br>内容类型<br>和短代码]
+    end
+
+
+    first ----> second
+     
+
+classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px;
+classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold
+classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000
+class A,B,D,E,F,G grey
+class S,T spacewhite
+class first,second white
+{{</ mermaid >}}
+
+<!-- 
+Figure 2. Preparation for your first contribution.
+-->
+图 2. 第一次贡献的准备工作。
+
+<!--
 - Read the [Contribution overview](/docs/contribute/new-content/overview/) to
   learn about the different ways you can contribute.
 - Check [`kubernetes/website` issues list](https://github.com/kubernetes/website/issues/)
@@ -127,13 +221,10 @@ roles and permissions.
 - Learn about [page content types](/docs/contribute/style/page-content-types/)
   and [Hugo shortcodes](/docs/contribute/style/hugo-shortcodes/).
 -->
-## 第一次贡献 {#your-first-contribution}
-
 - 通读[贡献概述](/zh/docs/contribute/new-content/overview/)，了解参与贡献的不同方式。
-- 查看[`kubernetes/website` 问题列表](https://github.com/kubernetes/website/issues/)
+- 查看 [`kubernetes/website` 问题列表](https://github.com/kubernetes/website/issues/)
   ，检索最适合作为切入点的问题。
-- 在现有文档上，
-  [使用 GitHub 提交 PR ](/zh/docs/contribute/new-content/open-a-pr/#changes-using-github)，
+- 在现有文档上，[使用 GitHub 提交 PR](/zh/docs/contribute/new-content/open-a-pr/#changes-using-github)，
   掌握在 GitHub 上登记 Issue 的方法。
 - Kubernetes 社区其他成员会[评审 PR ](/zh/docs/contribute/review/reviewing-prs/)，
   以确保文档精准和语言流畅。
@@ -157,11 +248,11 @@ roles and permissions.
 
 - 学习在仓库的[本地克隆中工作](/zh/docs/contribute/new-content/open-a-pr/#fork-the-repo)。
 - 为[发行版的特性](/zh/docs/contribute/new-content/new-features/)编写文档。
-- 加入 [SIG Docs](/zh/docs/contribute/participate/), 并成为[成员或评审者](/zh/docs/contribute/participate/roles-and-responsibilities/)。
+- 加入 [SIG Docs](/zh/docs/contribute/participate/)，并成为[成员或评审者](/zh/docs/contribute/participate/roles-and-responsibilities/)。
 
 - 开始或帮助[本地化](/zh/docs/contribute/localization/) 工作。
 
-<!--
+<!-- 
 ## Get involved with SIG Docs
 
 [SIG Docs](/docs/contribute/participate/) is the group of contributors who
@@ -170,37 +261,47 @@ involved with SIG Docs is a great way for Kubernetes contributors (feature
 development or otherwise) to have a large impact on the Kubernetes project.
 
 SIG Docs communicates with different methods:
-
-- [Join `#sig-docs` on the Kubernetes Slack instance](https://slack.k8s.io/). Make sure to
-  introduce yourself!
-- [Join the `kubernetes-sig-docs` mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-docs),
-  where broader discussions take place and official decisions are recorded.
-- Join the [weekly SIG Docs video meeting](https://github.com/kubernetes/community/tree/master/sig-docs). Meetings are always announced on `#sig-docs` and added to the [Kubernetes community meetings calendar](https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America/Los_Angeles). You'll need to download the [Zoom client](https://zoom.us/download) or dial in using a phone.
 -->
 ## 参与 SIG Docs 工作 {#get-involved-with-SIG-Docs}
 
 [SIG Docs](/zh/docs/contribute/participate/) 是负责发布、维护 Kubernetes 文档的贡献者团体。
 参与 SIG Docs 是 Kubernetes 贡献者（开发者和其他人员）对 Kubernetes 项目产生重大影响力的好方式。
 
-SIG Docs 的几种沟通方式:
-
+SIG Docs 的几种沟通方式：
+<!--
+- [Join `#sig-docs` on the Kubernetes Slack instance](https://slack.k8s.io/). Make sure to
+  introduce yourself!
+- [Join the `kubernetes-sig-docs` mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-docs),
+  where broader discussions take place and official decisions are recorded.
+- Join the [SIG Docs video meeting](https://github.com/kubernetes/community/tree/master/sig-docs) held every two weeks. Meetings are always announced on `#sig-docs` and added to the [Kubernetes community meetings calendar](https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America/Los_Angeles). You'll need to download the [Zoom client](https://zoom.us/download) or dial in using a phone.
+- Join the SIG Docs async Slack standup meeting on those weeks when the in-person Zoom video meeting does not take place. Meetings are always announced on `#sig-docs`. You can contribute to any one of the threads up to 24 hours after meeting announcement. 
+-->
 - [加入 Kubernetes 在 Slack 上的`#sig-docs` 频道](https://slack.k8s.io/)。
   一定记得自我介绍!
-- [加入`kubernetes-sig-docs` 邮件列表](https://groups.google.com/forum/#!forum/kubernetes-sig-docs),
+- [加入 `kubernetes-sig-docs` 邮件列表](https://groups.google.com/forum/#!forum/kubernetes-sig-docs),
   这里有更广泛的讨论，和官方决策的记录。
-- 参加 [SIG Docs 的每周视频会议](https://github.com/kubernetes/community/tree/master/sig-docs)。会议总是在 `#sig-docs` 上发出公告，同时添加到 
-  [Kubernetes社区会议日历](https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America/Los_Angeles)。
+- 参加每两周召开一次的 [SIG Docs 视频会议](https://github.com/kubernetes/community/tree/master/sig-docs)。
+  会议总是在 `#sig-docs` 上发出公告，同时添加到
+  [Kubernetes 社区会议日历](https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America/Los_Angeles)。
   你需要下载 [Zoom 客户端软件](https://zoom.us/download)，或电话拨号接入。
+- 如果有几周未召开实况 Zoom 视频会议，请参加 SIG Docs 异步 Slack 站会。
+  会议总是在 `#sig-docs` 上发出公告。
+  你可以在会议公告后 24 小时内为其中任一议题做贡献。
 
 <!--
 ## Other ways to contribute
 
 - Visit the [Kubernetes community site](/community/). Participate on Twitter or Stack Overflow, learn about local Kubernetes meetups and events, and more.
-- Read the [contributor cheatsheet](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet) to get involved with Kubernetes feature development.
+- Read the [contributor cheatsheet](https://www.kubernetes.dev/docs/contributor-cheatsheet/) to get involved with Kubernetes feature development.
+- Visit the contributor site to learn more about [Kubernetes Contributors](https://www.kubernetes.dev/) and [additional contributor resources](https://www.kubernetes.dev/resources/).
 - Submit a [blog post or case study](/docs/contribute/new-content/blogs-case-studies/).
 -->
 ## 其他贡献方式 {#other-ways-to-contribute}
 
-- 访问 [Kubernetes 社区网站](/zh/community/)。 参与 Twitter 或 Stack Overflow, 了解 Kubernetes 当地的聚会和活动, 等等。
-- 阅读[贡献者备忘单](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet)，参与 Kubernetes 功能开发。
+- 访问 [Kubernetes 社区网站](/zh/community/)。
+  参与 Twitter 或 Stack Overflow，了解当地的 Kubernetes 会议和活动等等。
+- 阅读[贡献者备忘单](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet)，
+  参与 Kubernetes 功能开发。
+- 访问贡献者网站，进一步了解有关 [Kubernetes 贡献者](https://www.kubernetes.dev/)
+  和[更多贡献者资源](https://www.kubernetes.dev/resources/)的信息。
 - 提交一篇[博客文章或案例研究](/zh/docs/contribute/new-content/blogs-case-studies/)。