ElectronのIssue
Issueへの貢献方法
Issueに対して、個人は基本的に3つの方法で貢献できます。
- Issueを提起して議論する: Electronに新しいバグを発見したと思われる場合は、
electron/electron
issueトラッカーに新しいIssueを作成して報告してください。 - Issueのトリアージを支援する: 補足的な詳細情報(バグを実証する再現可能なテストケース)を提供するか、Issueに対処するための提案を提供することで、これを行うことができます。
- Issueの解決を支援する: これは、Issueがバグではないこと、または修正済みであることを示すことによって行うことができます。しかし、より頻繁には、
electron/electron
のソースを具体的かつレビュー可能な方法で変更するプルリクエストを開くことによって行われます。
一般的なヘルプの求め方
Electronのウェブサイトには、プログラミングのヘルプを得る、セキュリティの問題を報告する、貢献する方法など、さまざまなリソースが掲載されています。Issueトラッカーはバグの報告にのみ使用してください!
バグレポートの提出
バグレポートを提出するには
electron/electron
issueトラッカーで新しいIssueを開くと、テンプレートが表示されるので、入力してください。
Electronにバグを発見したと思われる場合は、できる限りテンプレートに記入してください。
レポートを評価するために必要な情報のうち、最も重要な2つは、バグの説明と、それを再現するための簡単なテストケースです。再現できるバグは修正しやすいです。
最小限、完全、かつ検証可能な例を作成する方法を参照してください。
バグレポートのトリアージ
オープンなIssueには、議論が伴うのが一般的です。貢献者によっては、その動作がバグなのか機能なのかなど、意見が異なる場合があります。この議論はプロセスの一部であり、焦点を絞り、役に立ち、専門的である必要があります。
追加のコンテキストも裏付けとなる詳細も提供しない、ぶっきらぼうな回答は、役に立たず、専門的でもありません。多くの人にとって、そのような回答は迷惑で不親切です。
貢献者は、協力して問題を解決し、互いに進歩を支援することが推奨されます。無効と思われるIssueや、誤った情報が含まれているIssueに遭遇した場合は、なぜそう思うのかを、追加のコンテキストを添えて説明し、自分が間違っている可能性があることを納得させてもらう意思を持ってください。そうすることで、正しい結果に早く到達できることがよくあります。
バグレポートの解決
ほとんどのIssueは、プルリクエストを開くことによって解決されます。プルリクエストを開いてレビューするプロセスは、Issueを開いてトリアージするプロセスと似ていますが、提案された変更がElectronプロジェクトの最小限の品質と機能のガイドラインを満たしていることを確認するために必要なレビューと承認ワークフローが伴います。