MEP 模板#

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

状态#

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

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

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

  • 已完成: 实现已合并到主分支。

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

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

分支和拉取请求#

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

所有与此 MEP 相关的提交的拉取请求应在此处链接。(如果分阶段实现有意义,MEP 不需要在一个拉取请求中实现)。

摘要#

摘要应是对MEP将实现目标的简短描述。

详细描述#

本节描述了MEP的需求。它应该描述当前试图解决的问题以及为什么这个MEP能使情况变得更好。它应该包括新功能如何使用的示例,或许还有一些用例。

实现#

本节列出了实施MEP所需的主要步骤。在可能的情况下,应注明哪些步骤依赖于其他步骤,以及哪些步骤可以选择性地省略。在合理的情况下,每个步骤应包括与实施进展相关的拉取请求链接。

向后兼容性#

本节描述了MEP如何打破向后兼容性。

替代方案#

如果有任何解决同一问题的替代方案,它们应在此处讨论,并附上所选方法的理由。