Black lives matter.
We stand in solidarity with the Black community.
Racism is unacceptable.
It conflicts with the core values of the Kubernetes project and our community does not tolerate it.
We stand in solidarity with the Black community.
Racism is unacceptable.
It conflicts with the core values of the Kubernetes project and our community does not tolerate it.
如果你已经阅读并掌握开始贡献和中级贡献,并准备了解更多贡献的途径,请阅读此文。您需要使用 Git 命令行工具和其他工具做这些工作。
SIG Docs 的 approvers 可以成为 PR 管理者。SIG Docs approvers 会每周轮换地加入到 PR 管理者轮换日程中。
PR 管理者的工作职责包括:
size/XS
),然后逐渐扩展到最大的 PR(size/XXL
)。sig/
标签。reviewers:
块中指定审阅者。Docs Review
和 Tech Review
标签以标示 PR 的审阅状态。Needs Doc Review
或者 Needs Tech Review
标签。Doc Review: Open Issues
或者 Tech Review: Open Issues
标签。/lgtm
和 /approve
标签。执行管理操作时,以下查询很有用。完成以下三个查询后,剩余的要审阅的 PR 列表通常很小。
/approve
。dev-
分支,则表示它适用于即将发布的版本。请添加带有 /assign @<负责人的 github 账号>
的注释,确保发行版本负责人注意到该 PR。如果 PR 是针对旧分支,请帮助 PR 作者确定是否所针对的是最合适的分支。审查和批准是缩短和更新我们的 PR 队列的一种方式;另一种方式是关闭 PR。
关闭两个星期未签署 CLA 的 PR。 PR 作者可以在签署 CLA 后重新打开 PR,因此这是确保未签署 CLA 的 PR 不会被合并的一种风险较低的方法。
如果作者在两周或更长时间内未回复评论或反馈,请关闭 PR。
不要害怕关闭 PR。贡献者可以轻松地重新打开并继续工作。通常,关闭通知会激励作者继续完成其贡献。
要关闭 PR,请在 PR 上输入 /close
。
注意: 一项名为 [`fejta-bot`](https://github.com/fejta-bot) 的自动服务会在 issues 停滞 90 天后会自动将其标记为过期;然后再等 30 天,如果仍然无人过问,则将其关闭。PR 管理者应该在 issues 处于无人过问状态 14-30 天后关闭它们。
SIG Docs 的 成员 可以提出改进建议。
在对 Kubernetes 文档贡献了一段时间后,你可能会对样式指南、用于构建文档的工具链、网页样式、评审和合入 PR 的流程,或者文档的其他方面产生改进的想法。为了尽可能透明化,这些提议都需要在 SIG Docs 会议或 kubernetes-sig-docs 邮件列表上讨论。此外,在提出全面的改进之前,它能真正帮助我们了解有关“当前工作如何运作”和“以往的决定是为何做出”的背景。想了解文档的当前运作方式,最快的途径是咨询 kubernetes.slack.com 中的 #sig-docs
聊天群组。
在进行了讨论并且 SIG 就期望的结果达成一致之后,你就能以最合理的方式处理改进建议了。例如,样式指南或网站功能的更新可能涉及 PR 的新增,而与文档测试相关的更改可能涉及 sig-testing。
SIG Docs 的批准者(approvers) 可以为 Kubernetes 版本发布协调文档。
每一个 Kubernetes 版本都是由参与 sig-release 的 SIG(特别兴趣小组)的一个团队协调的。指定版本的发布团队中还包括总体发布牵头人,以及来自 sig-pm、sig-testing 的代表等。了解更多关于 Kubernetes 版本发布的流程,请参考 https://github.com/kubernetes/sig-release。
SIG Docs 团队的代表需要为一个指定的版本协调以下工作:
协调一个版本发布通常需要 3-4 个月的时间投入,该任务由 SIG Docs approvers 轮流承担。
SIG Docs approvers 可以担任新的贡献者大使。
新的贡献者大使共同努力欢迎 SIG-Docs 的新贡献者,对新贡献者的 PR 提出建议,以及在前几份 PR 提交中指导新贡献者。
新的贡献者大使的职责包括:
当前新贡献者大使将在每次 SIG 文档会议上以及 Kubernetes #sig-docs 频道中宣布。
SIG Docs 的 reviewers 可以为新的贡献者提供担保。
新的贡献者针对一个或多个 Kubernetes 项目仓库成功提交了 5 个实质性 PR 之后,就有资格申请 Kubernetes 组织 成员身份。贡献者的成员资格需要同时得到两位 reviewers 的保荐。
新的文档贡献者可以通过咨询 Kubernetes Slack 实例 上的 #sig-docs 频道或者 SIG Docs 邮件列表来请求评审者保荐。如果你对申请人的工作充满信心,你自愿保荐他们。当他们提交成员资格申请时,回复 “+1” 并详细说明为什么你认为申请人适合加入 Kubernetes 组织。
SIG Docs approvers 可以担任 SIG Docs 的联合主席。
Approvers 必须满足以下要求才能成为联合主席:
联合主席主要提供以下服务: 联合主席负责处理流程和政策、时间安排和召开会议、安排 PR 管理员、以及一些其他人不想做的事情,目的是增长贡献者团队。
职责范围包括:
为了安排和召开高效的会议,这些准则说明了如何做、怎样做以及原因。
坚持社区行为准则:
设定明确的议程:
对于每周一次的会议,请将前一周的笔记复制并粘贴到笔记的“过去的会议”部分中
通过协作,完成准确的记录:
清晰准确地分配执行项目:
根据需要来进行协调:
尊重大家的时间:
有效利用 Zoom:
准备开始录制时,请单击“录制到云”。
准备停止录制时,请单击“停止”。
视频会自动上传到 YouTube。