为 Kubernetes 文档做贡献
本网站由 Kubernetes SIG Docs 维护。Kubernetes 项目欢迎所有贡献者(无论是新手还是经验丰富者)的帮助!
Kubernetes 文档贡献者
- 改进现有内容
- 创建新内容
- 翻译文档
- 管理和发布 Kubernetes 发布周期中的文档部分
博客团队是 SIG Docs 的一部分,负责管理官方博客。请阅读 为 Kubernetes 博客做贡献,以了解更多信息。
说明
要了解有关为 Kubernetes 做贡献的更多信息,请参阅通用的 贡献者文档 网站。开始使用
任何人都可以针对文档提出问题,或者通过向 kubernetes/website GitHub 仓库 提交拉取请求 (PR) 来贡献更改。要有效地参与 Kubernetes 社区,您需要熟悉 git 和 GitHub。
参与文档
of K8s release cycle] end subgraph second[Review] direction TB T[ ] -.- D[Look over the
kubernetes/website
repository] --- E[Check out the
Hugo static site
generator] E --- F[Understand basic
GitHub commands] F --- G[Review open PR
and change review
processes] end subgraph first[Sign up] direction TB S[ ] -.- B[Sign the CNCF
Contributor
License Agreement] --- C[Join sig-docs
Slack channel] C --- V[Join kubernetes-sig-docs
mailing list] V --- M[Attend weekly
sig-docs calls
or slack meetings] end A([fa:fa-user New
Contributor]) --> first A --> second A --> third A --> H[Ask Questions!!!] 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
图 1 概述了新贡献者的路线图。您可以遵循 Sign up 和 Review 中的一些或所有步骤。现在您已准备好打开实现您的贡献目标的 PR,其中一些在 Open PR 下列出。再次,欢迎随时提问!
某些任务需要更多的信任和在 Kubernetes 组织中更多的访问权限。请参阅 参与 SIG Docs,以了解有关角色和权限的更多详细信息。
您的第一次贡献
在开始您的第一次贡献之前,您可以先查看几个步骤进行准备。图 2 概述了这些步骤和详细信息。
K8s members] --> A[Check kubernetes/website
issues list for
good first PRs] --> B[Open a PR!!] end subgraph first[Suggested Prep] direction TB T[ ] -.- D[Read contribution overview] -->E[Read K8s content
and style guides] E --> F[Learn about Hugo page
content types
and shortcodes] 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
- 阅读 贡献概述,以了解您可以贡献的不同方式。
- 查看
kubernetes/website问题列表,查找适合入门的问题。 - 使用 GitHub 打开拉取请求,了解现有文档并了解如何在 GitHub 中提交问题。
- 审查拉取请求,以确保 Kubernetes 社区成员的准确性和语言。
- 阅读 Kubernetes 内容 和 风格指南,以便您可以留下知情的评论。
- 了解 页面内容类型 和 Hugo shortcodes。
在贡献时获取帮助
您的第一次贡献可能会让人不知所措。新贡献者大使 会指导您完成您的前几次贡献。您可以在 Kubernetes Slack 中联系他们,最好是在 #sig-docs 频道中。此外,还有每月第一个星期二举行的 新贡献者见面问候电话。您可以在这里与新贡献者大使互动并解决您的问题。
后续步骤
学习 从仓库的本地克隆工作。
记录 发布中的特性。
开始或帮助进行 本地化。
参与 SIG Docs
SIG Docs 是发布和维护 Kubernetes 文档和网站的贡献者团队。参与 SIG Docs 是 Kubernetes 贡献者(无论是功能开发还是其他)对 Kubernetes 项目产生重大影响的好方法。
SIG Docs 使用不同的方法进行通信
- 加入 Kubernetes Slack 实例上的
#sig-docs。请务必介绍自己! - 加入
kubernetes-sig-docs邮件列表,更广泛的讨论在此处进行,并且官方决策会被记录。 - 加入 SIG Docs 视频会议,每两周举行一次。会议始终在
#sig-docs上公布,并添加到 Kubernetes 社区会议日历 中。您需要下载 Zoom 客户端 或使用电话拨入。 - 在不举行面对面 Zoom 视频会议的那些周,加入 SIG Docs 异步 Slack 站立会议。会议始终在
#sig-docs上公布。您可以在会议公布后的 24 小时内为任何一个线程做出贡献。
其他贡献方式
- 访问 Kubernetes 社区网站。在 Twitter 或 Stack Overflow 上参与,了解本地 Kubernetes 聚会和活动等。
- 阅读 贡献者备忘单,以了解如何参与 Kubernetes 功能开发。
- 访问贡献者网站,了解更多关于 Kubernetes 贡献者 和 其他贡献者资源 的信息。
- 学习如何 为官方博客做贡献
- 提交 案例研究