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