FLIP:Flax 改进流程

FLIP:Flax 改进流程#

大多数变更可以通过简单的议题/讨论和拉取请求进行讨论。

然而,有些变更的范围稍大或需要更多讨论,这些变更应以 FLIP 的形式实现。这样可以撰写更长的文档,并在拉取请求中进行讨论。

FLIP 的结构在初期会尽可能保持轻量,之后可能会进行扩展。

何时应使用 FLIP#

  • 当您的变更需要设计文档时。我们倾向于将设计文档作为 FLIP 收集,以便于发现和日后参考。

  • 当您的变更需要广泛讨论时。在议题或拉取请求中进行相对简短的讨论是可以的,但当讨论变得过长时,就不利于日后的理解。FLIP 允许用讨论摘要来更新主文档,并且这些更新本身可以在添加 FLIP 的拉取请求中进行讨论。

如何发起 FLIP#

首先,创建一个带有 FLIP 标签的议题。所有与该 FLIP 相关的拉取请求(即添加 FLIP 本身的拉取请求以及任何实施该 FLIP 的拉取请求)都应链接到此议题。

然后,创建一个拉取请求,其中包含一个 0000-template.md 的副本,并将其重命名为 %04d-{short-title}.md,其中的数字是议题编号。