介绍 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 成为活跃 (Active) 状态,PR 必须得到至少 2 名 API 工作组成员的批准。在合并之前,RFC 应同步展示并获得至少三分之二工作组成员法定人数的一致接受。如果达成共识,将启动一个为期一个月的最终评论期,之后 PR 将被合并。
如果实现在 electron/electron
中合并,一个活跃的 RFC 则为完成 (Completed) 状态。
谁可以参与?
Electron 社区中的任何人都可以提交 RFC 或在 electron/rfcs
仓库中留下反馈!
- 要查看活跃的 RFC 列表,请参阅 仓库中的
text
文件夹。 - 要对提议中的 RFC 留下反馈,请查看 开放的 PR 列表。
- 要提交新的 RFC,请查看仓库的 README 和 RFC 模板。
我们希望将此过程变为双向对话,并鼓励社区参与,以便从将来可能使用这些 API 的 Electron 应用中获取多样化的意见。如果您有兴趣对当前提议中的 RFC 留下反馈,Electron 维护者已经创建了一些
鸣谢
Electron 的 RFC 流程借鉴了许多成熟的开源 RFC 流程。许多想法和主要文案的灵感来自