角色与责任

    • 任何人（Anyone）：为 Kubernetes 文档作出贡献的普通贡献者。
    • 成员（Members）：可以对 Issue 进行分派和判别，对 PR 提出无约束性的评审意见。
    • 评审人（Reviewers）：可以领导对文档 PR 的评审，可以对变更的质量进行判别。
    • 批准人（Approvers）：可以领导对文档的评审并合并变更。

    任何拥有 GitHub 账号的人都可以对 Kubernetes 作出贡献。SIG Docs 欢迎所有新的贡献者。

    任何人都可以：

    • 在任何 Kubernetes 仓库，包括 上报告 Issue。
    • 对某 PR 给出无约束力的反馈信息
    • 在 Slack 或 上提出改进建议。

    在签署了 CLA 之后，任何人还可以：

    • 发起拉取请求（PR），改进现有内容、添加新内容、撰写博客或者案例分析
    • 创建示意图、图形资产或者嵌入式的截屏和视频内容

    进一步的详细信息，可参见。

    成员是指那些对 kubernetes/website 提交很多拉取请求（PR）的人。 成员都要加入 Kubernetes GitHub 组织。

    成员可以：

    • 执行节区所列举操作

    • 使用 /lgtm 评论添加 LGTM (looks good to me（我觉得可以）) 标签到某个 PR

      说明： 使用 /lgtm 会触发自动化机制。如果你希望提供非约束性的批准意见， 直接回复 “LGTM” 也是可以的。

    • 利用 /hold 评论来阻止某个 PR 被合并

    • 使用 /assign 评论为某个 PR 指定评审人

    • 对 PR 提供非约束性的评审意见

    • 使用自动化机制来对 Issue 进行判别和分类

    • 为新功能特性撰写文档

    在你成功地提交至少 5 个 PR 并满足 相关条件 之后：

    1. 找到两个或批准人为你的成员身份提供 。

      通过 Kubernetes Slack 上的 #sig-docs 频道 或者 来寻找为你担保的人。

      说明： 不要单独发送邮件给某个 SIG Docs 成员或在 Slack 中与其私聊。 在提交申请之前，一定要先确定担保人。

    2. 在 kubernetes/org 仓库 使用 Organization Membership Request Issue 模板登记一个 Issue。

      • 在 Issue 中 @<GitHub-username> 提及他们的 GitHub 用户名
      • 通过 Slack 或 email 直接发送给他们 Issue 链接

      担保人会通过 +1 投票来批准你的请求。一旦你的担保人批准了该请求， 某个 Kubernetes GitHub 管理员会将你添加为组织成员。恭喜！

      如果你的成员请求未被接受，你会收到一些反馈。 当处理完反馈意见之后，可以再次发起申请。

    4. 登录你的邮件账户，接受来自 Kubernetes GitHub 组织发出的成员邀请。

      说明： GitHub 会将邀请发送到你的账户中所设置的默认邮件地址。

    评审人负责评审悬决的 PR。 与成员所给的反馈不同，你必须处理评审人的反馈。 评审人是 GitHub 团队的成员。

    评审人可以：

    • 执行任何人和节区所列举的操作

    • 编辑代码中用户可见的字符串

    • 改进代码注释

    你可以是 SIG Docs 的评审人，也可以是某个主题领域的文档的评审人。

    为 PR 指派评审人

    自动化引擎会为每个 PR 自动指派评审人。 你可以通过为 PR 添加评论 来请求某个特定评审人来评审。

    如果所指派的评审人未能及时评审，其他的评审人也可以参与进来。 你可以根据需要指派技术评审人。

    LGTM 代表的是 “Looks Good To Me （我觉得可以）”，用来标示某个 PR 在技术上是准确的，可以被合并。 所有 PR 都需要来自某评审人的 /lgtm 评论和来自某批准人的 /approve 评论。

    来自评审人的 /lgtm 评论是具有约束性的，会触发自动化引擎添加 lgtm 标签。

    成为评审人

    当你满足相关条件时， 你可以成为一个 SIG Docs 评审人。 来自其他 SIG 的评审人必须为 SIG Docs 单独申请评审人资格。

    申请流程如下：

    1. 发起 PR，将你的 GitHub 用户名添加到 kubernetes/website 仓库中 文件的对应节区。

    2. 将 PR 指派给一个或多个 SIG Docs 批准人（ 下列举的用户名）。

    申请被批准之后，SIG Docs Leads 之一会将你添加到合适的 GitHub 团队。 一旦添加完成，@k8s-ci-robot 会在处理未来的 PR 时，将 PR 指派给你或者建议你来评审某 PR。

    批准人负责评审和批准 PR 以将其合并。 批准人是 GitHub 团队的成员。

    批准人可以执行以下操作：

    • 执行列举在任何人、和评审人节区的操作
    • 通过使用 /approve 评论来批准、合并 PR，发布贡献者所贡献的内容。
    • 就样式指南给出改进建议
    • 对文档测试给出改进建议
    • 对 Kubernetes 网站或其他工具给出改进建议

    如果某个 PR 已有 /lgtm 标签，或者批准人再回复一个 /lgtm，则这个 PR 会自动合并。 SIG Docs 批准人应该只在不需要额外的技术评审的情况下才可以标记 /lgtm。

    只有批准人和 SIG Docs Leads 可以将 PR 合并到网站仓库。 这意味着以下责任：

    • 批准人可以使用 /approve 命令将 PR 合并到仓库中。

      警告： 不小心的合并可能会破坏整个站点。在执行合并操作时，务必小心。

    • 确保所提议的变更满足要求。

      如果有问题或者疑惑，可以根据需要请他人帮助评审。

    • 在 /approve PR 之前，须验证 Netlify 测试是否正常通过。

    • 在批准之前，请访问 Netlify 的页面预览来确保变更内容可正常显示。

    • 参与 PR 管理者轮值排班 执行时长为一周的 PR 管理。SIG Docs 期望所有批准人都参与到此轮值工作中。 更多细节可参见 。

    成为批准人

    当你满足时，可以成为一个 SIG Docs 批准人。 来自其他 SIG 的批准人也必须在 SIG Docs 独立申请批准人资格。

    申请流程如下：

    1. 发起一个 PR，将自己添加到 kubernetes/website 仓库中 OWNERS_ALIASES 文件的对应节区。

      说明： 如果你不确定要添加到哪个位置，可以将自己添加到 中。

    2. 将 PR 指派给一个或多个 SIG Docs 批准人。

    • 阅读 ，了解所有批准人轮值的角色。