プルリクエスト
プルリクエストは、あるブランチの変更を別のブランチ(通常はデフォルトブランチ)にマージすることを提案するもので、マージの前にチームがレビュー、議論、承認を行う場所になります。
ブランチの作成
Section titled “ブランチの作成”変更内容を準備が整うまでデフォルトブランチから切り離しておくために、新しいブランチで作業します。
UIで作成する場合:
- リポジトリを開き、左上付近にあるブランチセレクター(現在のブランチ名が表示されています)を選択します。
- 検索ボックスに新しいブランチ名を入力し、Create Branch を選択します。
ローカルで作成する場合:
- ブランチを作成して切り替えます:
git checkout -b feature-x - 変更を加えてから、ステージしてコミットします:
git add .に続けてgit commit -m "Describe what changed" - ブランチをPlaidCloud Gitにプッシュします:
git push -u origin feature-x
プルリクエストの作成
Section titled “プルリクエストの作成”- リポジトリを開き、Pull Requests タブを選択して、New Pull Request を選択します。
- 比較ブランチにフィーチャーブランチを、ベースブランチにマージ先(通常は
mainまたはmaster)を設定します。 - わかりやすいタイトルと、何がなぜ変更されたかを説明する説明文を記述します。
- 関連する課題をリンクするには、説明文にクローズ用のキーワード(たとえば
Closes #12)を追加します。これにより、プルリクエストがマージされたときに課題が自動的にクローズされます。 - 必要に応じてレビュー担当者を割り当ててから、Create Pull Request を選択します。
変更のレビュー
Section titled “変更のレビュー”レビュー担当者は、何もマージせずにプルリクエストを確認します。
- プルリクエストを開き、Files Changed を選択して差分を確認します。
- 差分内の任意の行を選択すると、その変更に対するインラインコメントを残せます。
- 確認が終わったら、全体の判断を送信します。承認する場合は承認、先に修正を依頼する場合は Request Changes を選択します。
- 作成者は、フィードバックに対応するために同じブランチへコミットを追加でプッシュします。プルリクエストは自動的に更新されるため、新しく作成し直す必要はありません。
- レビュー担当者は、各指摘に対応が完了したら、個々のコメントスレッドを解決済みとしてマークします。
プルリクエストが承認されたら、次の手順に進みます。
- Merge ボタンの横にあるドロップダウンから、マージ方法を選択します。
- Create a merge commit — マージコミットを作成して、ブランチの履歴全体を保持します。
- Squash and merge — ブランチ上のすべてのコミットを、マージ先のブランチ上の1つのコミットにまとめます。
- Rebase and merge — マージコミットを作成せずに、ブランチのコミットをマージ先のブランチ上に再適用します。
- Merge を選択して完了します。
- 必要に応じて Delete Branch を選択し、不要になったフィーチャーブランチを削除します。