electron/rfcs 介绍
Electron 的 API 工作组正在采用开放的意见征集 (RFC) 流程,以帮助引导 Electron 核心的重大更改。
为什么需要 RFC?
简而言之,我们希望能够顺利地将重大变更引入 Electron 核心。
目前,新的代码更改主要通过 GitHub 上的 issue 和 pull request 进行讨论。对于大多数 Electron 的更改,这是一个很好的系统。许多 bug 修复、文档更改甚至新功能都足够简单,可以通过标准的 GitHub 流程进行异步审查和合并。
对于更重大的变更——例如,大型 API 接口或会影响大多数 Electron 应用的破坏性变更——在编写大部分代码之前,于构思阶段进行审查是很有意义的。
此流程被设计为向公众开放,这也将使广大的开源社区更容易在潜在变更进入 Electron 之前对其提供反馈。
它是如何运作的?
整个 RFC 流程位于 GitHub 上的 electron/rfcs 仓库中。步骤在仓库的 README 中有详细描述。
简而言之,一旦向 electron/rfcs
仓库提交了 PR,一个 RFC 就进入了提案(Proposed)阶段。一个提案中的 RFC 会进入
- 激活(Active)状态,当该 PR 被合并到仓库的
main
分支时,这意味着 Electron 维护者们同意在electron/electron
中实现该提案,或者 - 拒绝(Declined)状态,如果该 PR 最终被拒绝。
要使 RFC 变为“已激活”,PR 必须至少获得 2 名 API 工作组成员的批准。合并之前,RFC 应进行同步演示,并获得至少三分之二的 WG 成员法定人数的一致同意。如果达成共识,将触发为期一个月的最终评论期,之后 PR 将被合并。
一个激活状态的 RFC 在其实现被合并到 electron/electron
后,将进入完成(Completed)状态。
谁可以参与?
Electron 社区中的任何人都可以提交 RFC 或在 electron/rfcs
仓库中留下反馈!
- 要查看激活状态的 RFC 列表,请参考仓库中的
text
文件夹。 - 要对提案中的 RFC 留下反馈,请查看开放的 PR 列表。
- 要提交新的 RFC,请查看仓库的 README 和 RFC 模板。
我们希望使此过程成为双向对话,并鼓励社区参与,以获得可能在未来使用这些 API 的 Electron 应用程序的各种意见。如果您有兴趣对当前提议的 RFC 发表评论,Electron 的维护者已经创建了一些。
致谢
Electron 的 RFC 流程是基于许多已建立的开源 RFC 流程建模的。许多想法的灵感和主要文案部分都来自于: