プル要求では、あるブランチから別のブランチにコード変更をマージすることを提案します。 共同機能として、pull requests を使用すると、プロジェクトの一部になる前に作業について話し合い、レビューすることができます。
pull request を使用する理由
プル要求は、一連のコード変更を会話に変換します。 作業を直接マージするのではなく、共同作業者が意見を出せるように提案します。 これは、お客様とチームが、いくつかの方法で高品質で安全なコードを維持するのに役立ちます。
- メイン ブランチに到達する前に、バグや問題を早期にキャッチします。
- 特定の行に関連付けられたフィードバックを使用して、一緒に変更について話し合い、改善します。
- 変更された内容とその理由を明確に確認できる履歴を保持します。
プルリクエストでできること
プル要求を使用すると、変更を簡単に確認および検証できます。 pull request を使用すると、次のことができます。
- ブランチまたはフォークから変更を提案する。
- 提案された変更について、1 行ずつ話し合って確認します。
- 変更に対してテスト、ビルド、コード スキャンなどの自動チェックを実行します。
- フィードバックに対応し、変化に応じてプル リクエストを更新します。
- レビューが完了し、必要なチェックに合格したら、変更をマージしてください。
プルリクエストの主要な部分
pull request は、自分とレビュー担当者が必要とするすべてのものを 1 つの場所に収集します。
- 会話 には、説明、コメント、レビュー、アクティビティのタイムラインが表示されます。
- コミットは、 時間の経過と同時にブランチがどのように変化したかを示します。
- チェック では、自動テスト、ビルド、およびその他の検証の結果が表示されます。
- 変更されたファイル には、レビュアーがコメントする対象の差分が表示されます。
- マージ ボックスには、変更をマージできるかどうかが要約されます。 プル要求をマージする前に、必要なレビューやチェックなど、引き続き何が必要かを示します。
pull requests がワークフローにどのように適合するか
変更を提案する場合でも、他のユーザーのレビューを行う場合でも、pull request はいくつかの段階に従います。
- リポジトリを分岐またはフォークして、作業する分離された場所を作成します。
- 作業の履歴を作成して、変更をコミットします。
- プル要求を開いて 、変更をベース ブランチにマージすることを提案します。
- 必要に応じて更新を行い、コラボレーターと変更を確認して話し合います。
- 準備ができたら、pull request をマージします。