文档审阅流程

    文档审阅者 是一个受信任的贡献者，负责批准符合审阅标准的内容。 所有审阅都遵循 中描述的流程。

    只有文档维护者和工作组负责人才能将内容合并到 istio.io 存储库。

    文档审阅者、维护者和工作组负责人，对 PR 内容的审阅必须遵循审阅流程，以确保所有审阅一致。流程如下：

    1. 贡献者提交新的 PR 到 istio.io 仓库。
    2. 审阅者进行内容审阅，并确定它是否符合。
    3. 如果贡献者尚未加入任何与贡献内相关的技术工作组，则审阅者可将其加入到相应工作组。
    4. 贡献者和审阅者协同工作，直到内容符合所有绝对验收标准，且 Issue 得到完全解决。
    5. 如果内容非常紧急，且满足需要大量工作，审阅者 可在 istio.io 仓库提交跟进 Issue，以在后续处理这些问题。
    6. 当 技术工作组负责人或维护者批准 PR 内容，审阅者 可以批准 PR。
    7. 如果 Docs WG 维护者或负责人审阅了内容，则他们不仅会批准内容，还会对其进行合并。否则，维护者和负责人将自动收到审阅者的批准通知，并优先批准和合并已审阅的内容。

    下图描述了该流程：

    • 贡献者 执行步骤在灰色节点。
    • 审阅者 执行步骤在蓝色节点。
    • 文档维护者和工作组负责人 执行步骤在绿色节点。

    当审阅者在 中提出跟进 Issue 时，需在 Issue 中包含以下信息：

    • 关于内容不符合补充接受标准的详细信息。
    • 指向原始 PR 的链接。
    • 技术主题专家（SMEs）用户名。
    • 添加 Labels 以便于问题排序。
    • 工作量估计：审阅者提供与原始贡献者一起解决剩余问题所需的最佳估计时间。

    审阅流程，通过将明确的审阅标准应用于所有内容以支持我们的。

    • 正确的编码：必须通过所有的 lint 检查和测试。
    • 语言：内容必须清晰易懂。要了解更多信息，请参阅 Google 开发者风格指南的 highlights 和 。
    • 链接和导航：内容中涉及的所有链接必须有效，且网站可以正常构建。

    补充验收标准

    • 内容结构：良好的信息结构可增强阅读体验。
    • 一致性：内容遵循 中的所有建议。
    • 风格：内容遵循 Google 开发者风格指南。
    • 图形附件：遵循 Istio 。
    • 示例代码：提供与内容密切相关且可测试的有效代码示例。
    • 内容服用：任何可重复的内容都遵循使用样板文本的可重用性策略。
    • 术语：所有新的术语都已经添加到术语表中，且定义清晰。