MEP 模板#

此 MEP 模板是 MEP 应包含的部分的指南.如果合适,可以添加额外的部分,不必要的部分可以注明.

状态#

MEP 在其生命周期中经历多个阶段:

  • 讨论:MEP 正在邮件列表上积极讨论,并由其作者进行改进.MEP 的邮件列表讨论应在主题行中包含 MEP 编号 (MEPxxx),以便可以轻松地将其与 MEP 相关联.

  • 进展:已达成共识,实施工作已经开始.

  • 已完成:实施已合并到主分支.

  • 已取代:此 MEP 已被放弃,转而采用另一种方法.

  • 已拒绝:目前没有实施该提案的计划.

分支和 Pull requests#

包含此 MEP 工作的所有的开发分支都应该从这里链接.

所有与此 MEP 相关的提交的 pull requests 都应该从这里链接.(如果以离散阶段实现更有意义,则 MEP 不需要在单个 pull request 中实现).

摘要#

摘要应该简要描述 MEP 将实现的目标.

详细描述#

本节描述了 MEP 的需求.它应描述其尝试解决的现有问题,以及为什么此 MEP 使情况变得更好.它应包括如何使用新功能的示例,以及一些用例.

实施#

本节列出了实施 MEP 所需的主要步骤.在可能的情况下,应注明一个步骤依赖于另一个步骤的位置,以及哪些步骤可以有选择地省略.在有意义的地方,每个步骤都应包括与实施进度相关的 pull requests 的链接.

向后兼容性#

本节描述了 MEP 打破向后不兼容性的方式.

替代方案#

如果存在任何解决相同问题的替代方案,则应在此处讨论,并说明选择的方法的理由.

On this page