角色与责任
任何人都可以为 Kubernetes 作出贡献。随着你对 SIG Docs 的贡献增多,你可以申请 社区内不同级别的成员资格。 这些角色使得你可以在社区中承担更多的责任。 每个角色都需要更多的时间和投入。具体包括:
- 任何人(Anyone):为 Kubernetes 文档作出贡献的普通贡献者。
- 成员(Members):可以对 Issue 进行分派和判别,对 PR 提出无约束性的评审意见。
- 评审人(Reviewers):可以领导对文档 PR 的评审,可以对变更的质量进行判别。
- 批准人(Approvers):可以领导对文档的评审并合并变更。
任何人(Anyone)
任何拥有 GitHub 账号的人都可以对 Kubernetes 作出贡献。SIG Docs 欢迎所有新的贡献者。
任何人都可以:
- 在任何 Kubernetes 仓库,包括
kubernetes/website
上报告 Issue。 - 对某 PR 给出无约束力的反馈信息
- 为本地化提供帮助
- 在 Slack 或 SIG Docs 邮件列表 上提出改进建议。
在签署了 CLA 之后,任何人还可以:
- 发起拉取请求(PR),改进现有内容、添加新内容、撰写博客或者案例分析
- 创建示意图、图形资产或者嵌入式的截屏和视频内容
进一步的详细信息,可参见贡献新内容。
成员(Members)
成员是指那些对 kubernetes/website
提交很多拉取请求(PR)的人。
成员都要加入 Kubernetes GitHub 组织。
成员可以:
-
执行任何人节区所列举操作
-
使用
/lgtm
评论添加 LGTM (looks good to me(我觉得可以)) 标签到某个 PR说明:
使用/lgtm
会触发自动化机制。如果你希望提供非约束性的批准意见, 直接回复 "LGTM" 也是可以的。 -
利用
/hold
评论来阻止某个 PR 被合并 -
使用
/assign
评论为某个 PR 指定评审人 -
对 PR 提供非约束性的评审意见
-
使用自动化机制来对 Issue 进行判别和分类
-
为新功能特性撰写文档
成为一个成员
在你成功地提交至少 5 个 PR 并满足 相关条件 之后:
-
通过 Kubernetes Slack 上的 #sig-docs 频道 或者 SIG Docs 邮件列表 来寻找为你担保的人。
说明:
不要单独发送邮件给某个 SIG Docs 成员或在 Slack 中与其私聊。 在提交申请之前,一定要先确定担保人。 -
在
kubernetes/org
仓库 使用 Organization Membership Request Issue 模板登记一个 Issue。
-
告知你的担保人你所创建的 Issue,你可以:
- 在 Issue 中
@<GitHub-username>
提及他们的 GitHub 用户名 - 通过 Slack 或 email 直接发送给他们 Issue 链接
担保人会通过
+1
投票来批准你的请求。一旦你的担保人批准了该请求, 某个 Kubernetes GitHub 管理员会将你添加为组织成员。恭喜!如果你的成员请求未被接受,你会收到一些反馈。 当处理完反馈意见之后,可以再次发起申请。
- 在 Issue 中
-
登录你的邮件账户,接受来自 Kubernetes GitHub 组织发出的成员邀请。
说明:
GitHub 会将邀请发送到你的账户中所设置的默认邮件地址。
评审人(Reviewers)
评审人负责评审悬决的 PR。 与成员所给的反馈不同,身为 PR 作者必须处理评审人的反馈。 评审人是 @kubernetes/sig-docs-{language}-reviews GitHub 团队的成员。
评审人可以:
-
评审 PR 并提供具约束性的反馈信息
说明:
要提供非约束性的反馈,可以在你的评语之前添加 "Optionally: " 这样的说法。
-
编辑代码中用户可见的字符串
-
改进代码注释
你可以是 SIG Docs 的评审人,也可以是某个主题领域的文档的评审人。
为 PR 指派评审人
自动化引擎会为每个 PR 自动指派评审人。
你可以通过为 PR 添加评论 /assign [@_github_handle]
来请求某个特定评审人来评审。
如果所指派的评审人未能及时评审,其他的评审人也可以参与进来。 你可以根据需要指派技术评审人。
使用 /lgtm
LGTM 代表的是 “Looks Good To Me (我觉得可以)”,用来标示某个 PR
在技术上是准确的,可以被合并。
所有 PR 都需要来自某评审人的 /lgtm
评论和来自某批准人的 /approve
评论。
来自评审人的 /lgtm
评论是具有约束性的,会触发自动化引擎添加 lgtm
标签。
成为评审人
当你满足相关条件时, 你可以成为一个 SIG Docs 评审人。 来自其他 SIG 的评审人必须为 SIG Docs 单独申请评审人资格。
申请流程如下:
-
发起 PR,将你的 GitHub 用户名添加到
kubernetes/website
仓库中 OWNERS_ALIASES 文件的对应节区。说明:
如果你不确定要添加到哪个位置,可以将自己添加到sig-docs-en-reviews
。 -
将 PR 指派给一个或多个 SIG Docs 批准人(
sig-docs-{language}-owners
下列举的用户名)。
申请被批准之后,SIG Docs Leads 之一会将你添加到合适的 GitHub 团队。 一旦添加完成,@k8s-ci-robot 会在处理未来的 PR 时,将 PR 指派给你或者建议你来评审某 PR。
批准人(Approvers)
批准人负责评审和批准 PR 以将其合并。 批准人是 @kubernetes/sig-docs-{language}-owners GitHub 团队的成员。
批准人可以执行以下操作:
- 执行列举在任何人、成员和评审人节区的操作
- 通过使用
/approve
评论来批准、合并 PR,发布贡献者所贡献的内容。 - 就样式指南给出改进建议
- 对文档测试给出改进建议
- 对 Kubernetes 网站或其他工具给出改进建议
如果某个 PR 已有 /lgtm
标签,或者批准人再回复一个 /lgtm
,则这个 PR 会自动合并。
SIG Docs 批准人应该只在不需要额外的技术评审的情况下才可以标记 /lgtm
。
批准 PR
只有批准人和 SIG Docs Leads 可以将 PR 合并到网站仓库。 这意味着以下责任:
-
批准人可以使用
/approve
命令将 PR 合并到仓库中。警告:
不小心的合并可能会破坏整个站点。在执行合并操作时,务必小心。
-
确保所提议的变更满足文档内容指南要求。
如果有问题或者疑惑,可以根据需要请他人帮助评审。
-
在
/approve
PR 之前,须验证 Netlify 测试是否正常通过。 -
在批准之前,请访问 Netlify 的页面预览来确保变更内容可正常显示。
-
参与 PR 管理者轮值排班 执行时长为一周的 PR 管理。SIG Docs 期望所有批准人都参与到此轮值工作中。 更多细节可参见 PR 管理者。
成为批准人
当你满足一定条件时,可以成为一个 SIG Docs 批准人。 来自其他 SIG 的批准人也必须在 SIG Docs 独立申请批准人资格。
申请流程如下:
-
发起一个 PR,将自己添加到
kubernetes/website
仓库中 OWNERS_ALIASES 文件的对应节区。说明:
如果你不确定要添加到哪个位置,可以将自己添加到sig-docs-en-owners
中。 -
将 PR 指派给一个或多个 SIG Docs 批准人。
请求被批准之后,SIG Docs Leads 之一会将你添加到对应的 GitHub 团队。 一旦添加完成,K8s-ci-robot 会在处理未来的 PR 时,将 PR 指派给你或者建议你来评审某 PR。
接下来
- 阅读 PR 管理者,了解所有批准人轮值的角色。