跳转到主要内容

electron/rfcs 介绍

·阅读时长 4 分钟

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 仓库中留下反馈!

我们希望这个过程成为一种双向对话,并鼓励社区参与,以便从未来可能使用这些 API 的 Electron 应用中获得多样化的意见。如果您有兴趣对当前提案中的 RFC 留下反馈,Electron 维护者们已经创建了一些:

致谢

Electron 的 RFC 流程是基于许多已建立的开源 RFC 流程建模的。许多想法的灵感和主要文案部分都来自于: