增强请求¶
受 Kubernetes 增强功能 的启发,网关 API 提供了一个用于在项目中引入新功能或重大更改的过程。随着项目的成熟,增强流程将随着时间的推移而不断发展。
增强功能为社区路线图提供了基础。增强功能可以由任何人提出,但需要维护人员批准才能将增强功能纳入项目。
什么是增强功能?¶
增强功能通常是指任何
- 对 API 进行更改。
- 需要大量工作才能实施。
- 需要文档才能使用。
- 影响系统操作方式,包括添加或删除重要功能。
以下情况不太可能需要增强功能:
- 修复错误
- 添加更多测试
- 代码重构
如果您不确定拟议的工作是否需要增强功能,请提交一个问题并询问。
新的增强流程¶
在 GEP 概述 页面上记录了创建新的增强建议的过程。请参阅该页面以获取有关如何记录新的 GEP 以及它在走向完成状态的过程中将遵循的流程的所有详细信息。
在提交增强请求之前,必须存在某种形式的已记录讨论,如果该增强功能是非平凡的(我们将其定义为:涉及对 API 规范的更改或对最终用户有某种影响)。
请使用我们的 Github 讨论 论坛作为开始的初始位置,并随时将该讨论带到我们的 社区会议 之一中进行同步对话。如果创建的请求不包含对我们社区会议中的讨论和/或讨论记录的引用,请注意,它可能会被关闭,并要求您首先创建初始讨论。
何时接受增强功能?¶
网关 API 具有可预测的发布周期,其中包括多个阶段。新的增强功能仅在该发布周期的早期阶段被考虑,此时正在确定发布范围。有关更多信息,请参阅我们的 发布周期文档。
为什么跟踪增强功能¶
随着项目的不断发展,社区了解增强功能如何影响项目至关重要。从个人的角度来看,很难了解系统所有部分的交互方式,但作为社区,我们可以共同努力,在深入实施之前构建正确的设计和方法。
何时对增强问题发表评论¶
请在增强问题上发表评论以
- 请求对过程进行审查或澄清
- 更新增强工作的状态
- 链接到其他存储库中的相关问题