跳至内容

文档风格指南

网关 API 旨在尽可能地遵循上游 Kubernetes 文档风格指南。此指南应被视为该指南的扩展。如有冲突的指南,本指南中包含的信息优先于网关 API 文档。

项目名称

此项目名为“网关 API”,而不是“网关 API”。因此,使用“网关 API”的唯一情况是它属于更广泛的术语的一部分,例如“网关 API 维护者”。

提示

为了在文档中实现提示,我们使用 mkdocs-material 提醒.

发布渠道

只要有可能,我们都会尽量明确说明某个资源或功能当前包含在哪个发布渠道中,以及它是在哪个版本中引入到该渠道的。为此,我们使用类似于以下的提醒

标准渠道,自 v0.5.0 起

HTTPRoute 资源是 GA,并且自 v0.5.0 起一直是标准渠道的一部分。有关发布渠道的更多信息,请参阅我们的 版本控制指南.

实验渠道,自 v0.3.0 起

TLSRoute 资源是 Alpha,并且自 v0.3.0 起一直是实验渠道的一部分。有关发布渠道的更多信息,请参阅我们的 版本控制指南.

图表

在许多情况下,图表是解释概念的最佳方式。不幸的是,它们可能难以维护和更新。为了确保图表更易于维护,我们强烈建议使用对 Mermaid 图表的内置支持。以下是一个简单的图表示例

flowchart TD
    Start --> Stop

只要使用 Mermaid 图表不切实际,我们要求您链接到一个资源,以便任何人都可以复制和编辑该资源。