说明:

要了解有关为 Kubernetes 做出贡献的更多信息,请参阅 。

你还可以阅读 CNCF 关于为 Kubernetes 做贡献的。

本网站由 Kubernetes SIG Docs(文档特别兴趣小组)维护。

Kubernetes 文档项目的贡献者:

  • 改进现有内容
  • 创建新内容
  • 翻译文档
  • 管理并发布 Kubernetes 周期性发行版的文档

任何人都可以提出文档方面的问题(issue),或贡献一个变更,用拉取请求(PR)的方式提交到 GitHub 上的 kubernetes/website 仓库。 当然你需要熟练使用 和 GitHub 才能在 Kubernetes 社区中有效工作。

  1. 签署 CNCF 的。
  2. 确保理解发起 PR 和的基本流程。

flowchart TB subgraph third[发起 PR] direction TB U[ ] -.- Q[改进现有内容] —- N[创建新内容] N —- O[翻译文档] O —- P[管理并发布 K8s
周期性发行版的文档] end subgraph second[评审] direction TB T[ ] -.- D[仔细查看
kubernetes/website
仓库] —- E[下载安装 Hugo
静态站点
生成器] E —- F[了解基本的
GitHub 命令] F —- G[评审待处理的 PR
并遵从变更审查
流程] end subgraph first[注册] direction TB S[ ] -.- B[签署 CNCF
贡献者
许可协议] —- C[加入 sig-docs
Slack 频道] C —- V[加入 kubernetes-sig-docs
邮件列表] V —- M[参加每周的
sig-docs 电话会议
或 slack 会议] end A([fa:fa-user 新的
贡献者]) —> 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

必须启用 JavaScript 才能查看此页内容

图 1. 新手入门指示。

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

有些任务要求 Kubernetes 组织内更高的信任级别和访问权限。 阅读,获取角色和权限的更多细节。

你可以提前查阅几个步骤,来准备你的第一次贡献。 图 2 概述了后续的步骤和细节。

必须 JavaScript 才能查看此页内容

图 2. 第一次贡献的准备工作。

  • 通读贡献概述,了解参与贡献的不同方式。
  • 查看 , 检索最适合作为切入点的问题。
  • 在现有文档上,使用 GitHub 提交 PR, 掌握在 GitHub 上登记 Issue 的方法。
  • Kubernetes 社区其他成员会, 以确保文档精准和语言流畅。
  • 阅读 kubernetes 的内容指南和 ,以发表有见地的评论。
  • 了解页面内容类型和 。

SIG Docs 的几种沟通方式:

  • 。 一定记得自我介绍!
  • 加入 kubernetes-sig-docs 邮件列表, 这里有更广泛的讨论,和官方决策的记录。
  • 参加每两周召开一次的 。 会议总是在 上发出公告,同时添加到 Kubernetes 社区会议日历。 你需要下载 ,或电话拨号接入。
  • 如果有几周未召开实况 Zoom 视频会议,请参加 SIG Docs 异步 Slack 站会。 会议总是在 #sig-docs 上发出公告。 你可以在会议公告后 24 小时内为其中任一议题做贡献。
  • 访问 。 参与 Twitter 或 Stack Overflow,了解当地的 Kubernetes 会议和活动等等。
  • 阅读贡献者备忘单, 参与 Kubernetes 功能开发。
  • 访问贡献者网站,进一步了解有关 和更多贡献者资源的信息。
  • 提交一篇。