electron/rfcsの紹介
ElectronのAPIワーキンググループは、Electronコアへの大規模な変更を管理するために、オープンな**コメント依頼(RFC)**プロセスを採用しています。
RFCの理由
簡単に言うと、Electronコアへの重要な変更の着陸プロセスを円滑化したいと考えています。
現在、新しいコード変更は主にGitHubのissueとプルリクエストを通じて議論されています。Electronのほとんどの変更に対して、これは良いシステムです。多くのバグ修正、ドキュメントの変更、さらには新しい機能も、標準的なGitHubフローを通じて非同期的にレビューおよびマージするのに十分簡単です。
より重要な変更(例:大規模なAPIサーフェスや、ほとんどのElectronアプリに影響を与える破壊的変更)の場合、ほとんどのコードが記述される前に、構想段階でレビューを行うことが理にかなっています。
このプロセスは一般公開することを目的としており、オープンソースコミュニティ全体がElectronに反映される前に潜在的な変更についてフィードバックしやすくなります。
仕組み
RFCプロセス全体は、GitHubのelectron/rfcsリポジトリに存在します。手順は、リポジトリのREADMEに詳細に記載されています。
簡単に言うと、RFCは、electron/rfcs
リポジトリにPRが作成されると**提案**されます。提案されたRFCは、
- リポジトリの
main
ブランチにPRがマージされると**アクティブ**になり、これはElectronのメンテナがelectron/electron
への実装を承認していることを意味します。または、 - PRが最終的に拒否された場合は**拒否**されます。
RFCが**アクティブ**になるには、少なくとも2人のAPIワーキンググループメンバーによってPRが承認される必要があります。マージする前に、RFCは同期的に提示され、WGメンバーの少なくとも3分の2の定足数によって満場一致で承認される必要があります。コンセンサスが得られた場合、1ヶ月の最終コメント期間が開始され、その後PRがマージされます。
実装がelectron/electron
にマージされると、アクティブなRFCは**完了**します。
参加資格
Electronコミュニティの誰でもRFCを提出したり、electron/rfcs
リポジトリにフィードバックを残したりできます!
- アクティブなRFCのリストを見るには、リポジトリの
text
フォルダを参照してください。 - 提案されたRFCにフィードバックを残すには、未解決のPRのリストを確認してください。
- 新しいRFCを提出するには、リポジトリのREADMEとRFCテンプレートを確認してください。
このプロセスを双方向の対話にし、コミュニティの参加を促進して、将来これらのAPIを使用する可能性のあるElectronアプリからの多様な意見を得たいと考えていました。現在提案されているRFCへのフィードバックを残すことに関心がある場合は、Electronのメンテナが既にいくつか作成しています。
クレジット
ElectronのRFCプロセスは、多くの確立されたオープンソースRFCプロセスをモデルとしています。多くのアイデアやコピーライティングの主要部分のインスピレーションは、以下に由来します。