使用 GitHub 参与社区活动

    • 添加新文件到存储库。
    • 现有文件。
    • 审阅添加或修改的文件。

    该贡献指南假定您可以完成以下任务：

    • Fork 。
    • 为您的更改创建分支。
    • 向该分支添加提交。
    • 打开一个 PR 分享您的贡献。

    要为 Istio 贡献文档，您需要：

    1. 创建 GitHub 帐户。

    2. 签署。

    3. 安装 Docker，以预览和测试您的文档更改。

    文档是根据 协议许可发布的。

    1. 将 添加到 URL 的开头。例如，要编辑 https://istio.io/about，新 URL 应为 https://preliminary.istio.io/about。
    2. 单击右下角的铅笔图标。
    3. 在 GitHub UI 上进行编辑。
    4. 创建 Pull Request 提交您的修改。

    请参阅我们在贡献新内容或中的指南， 以了解有关提交更多实质性更改的详细信息。

    文档内容的维护在 istio/istio.io 仓库 Master 分支进行，Istio 发布当天，我们基于 Master 创建发布分支。以下链接指向我们在 GitHub 上的存储库：

    查看站点源码

    Istio 文档存储库使用多个分支发布所有 Istio 版本的文档。每个 Istio 发布都有相应的文档分支。例如，类似 、release-1.1、release-1.2 等分支，都是在相应的发布日创建的。若要查看特定版本的文档，请参阅。

    这种分支策略允许我们提供以下 Istio 在线资源：

    • 发布站点提供当前最新发布分支的内容。

    • 提供所有已发布分支的内容。

    考虑到分支的工作原理，如果您提交修改到 master 分支，在 Istio 的下一个 major 版本发布前，这些更改都不会被应用到 istio.io。 如果您的文档更改和当前 Istio 版本密切相关，也可以将更改应用到当前版本的 Release 分支。您可以通过在文档的 PR 上使用 cherry-pick 标签，自动地执行此操作。 例如，如果您在 PR 中向 master 分支引入了更正，则可以通过 标签以将此更改合并到 release-1.4 分支。

    一旦您的初始 PR 被合并，将自动在 Release 分支创建一个包含您的更改的 PR。为了使 CLA 机器人可以继续工作，您可能需要在 PR 上添加一个内容为 @googlebot I consent 的评论。

    在极少数情况下，cherry picks 功能可能无效。发生这种情况时，自动化程序将在原始 PR 中留下一条注释，表明它已失败。发生这种情况时，您将需要手动创建 cherry pick，并处理阻止该过程自动运行的合并问题。

    请注意，我们只会在当前版本的 Release 分支中应用更改，而不会在旧版本中进行。较旧的分支被视为已归档，并且通常不再接收任何更改。

    根据您的贡献和责任，您可以扮演多个角色。

    访问我们的社区，您可以全面了解有关 Istio 社区的更多信息。