機能ブランチから作業し、main ブランチからは行わないでください¶
変更作業を始める前に、必ずブランチを作成してください。デフォルトでは、リポジトリのフォークをクローンすると、main
ブランチがチェックアウトされます。これは BeeWare の main ブランチの直接コピーです。
main
ブランチからプルリクエストを送信することは可能ですが、そうしない方が望ましいです。ほぼ正しいプルリクエストを送信した場合、レビュー担当のコアチームメンバーは、小さな変更を求めるフィードバックを与える代わりに、必要な修正を加えられる可能性があります。しかし、main
ブランチからプルリクエストを送信すると、レビュー担当者は修正を加えられなくなります。
メインブランチで作業すると、最初のプルリクエストを完了した後のあなた自身にとっても困難になります。2つ目のプルリクエストに取り組む場合、2つ目の貢献の基盤となるアップストリームプロジェクトのメインブランチの「クリーンな」コピーが必要になります。最初の貢献をmainブランチから行った場合、そのクリーンなバージョンはもはや利用できません。
その代わりに、変更は 機能ブランチ で行うべきです。機能ブランチには、行った変更を識別するためのシンプルな名前が付けられます。 たとえば、Windows
11でのビルドに問題を引き起こすバグを修正する場合、fix-win11-buildというフィーチャーブランチを作成します。バグが報告済みの特定の課題に関連している場合は、ブランチ名にその課題番号を含めることも一般的です（例：fix-1234）。
fix-win11-build 機能ブランチを作成するには、次のコマンドを実行します:
(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build