pull request のレビュー

この記事では、次の方法について説明します。

この記事では、次の方法について説明します。

• Repos を Azure DevOps プロジェクト設定で有効にする必要があります。 Repos ハブと関連ページが表示されない場合は、Azure DevOps サービスのオンとオフの切り替えに関するページを参照して Repos を再度有効にしてください。

• PR を確認するには、PR が存在する Azure DevOps プロジェクトのメンバーであり、少なくとも Basic アクセス権を持つ必要があります。

  • プロジェクトがない場合は、作成するか、無料でサインアップします。

  • プロジェクト メンバーでない場合は、追加してもらいます。

  注意

  パブリック プロジェクトの場合、利害関係者アクセス権を付与されたユーザーは、Azure Repos へのフル アクセス権があります。

• Repos を Azure DevOps プロジェクト設定で有効にする必要があります。 Repos ハブと関連ページが表示されない場合は、Azure DevOps サービスのオンとオフの切り替えに関するページを参照して Repos を再度有効にしてください。

• PR を確認するには、少なくとも Basic アクセス権を持つ Azure DevOps プロジェクトのメンバーになります。 プロジェクト メンバーでない場合は、追加してもらいます。

PR は、Azure DevOps コマンド ライン インターフェイス (CLI) を使用して、Azure DevOps Services で管理できます。 Azure DevOps CLI は、Azure CLI と AzureDevOps 拡張機能をインストールする場合に使用できます。 PR を管理する CLI コマンドの一覧については、az repos pr コマンドを参照してください。

pull request を使用すると、指定されたレビュー担当者は、提案された変更がリポジトリのターゲット ブランチに適用される前に、それらを調査、議論、投票できます。 別のブランチで同じファイルを使用して開発を行う場合は、競合する変更が発生する可能性があることに注意してください。 その場合は、それらの競合を慎重に分析して解決する必要があります。 これを行うには、ソース、ターゲット、または両方のブランチからの変更を正しく適用するために、ファイルを手動で編集する必要がある場合があります。 ソースまたはターゲットからすべての変更を適用 (1 回のボタン クリックで実行できます) することは最適ではない可能性があり、必要な変更の一部が失われる可能性があります。 これは、ADO ツールを使用して行うことができます。または、開発ツール (Visual Studio など) を使用すると、より便利です。

詳細については、「マージの競合を解決する」を参照してください。

次の手順では、Azure Repos の PR のレビュー担当者が PR をナビゲートして、提案された変更を理解する方法について説明します。

1. Web ブラウザーから、Azure DevOps 組織のチーム プロジェクトを開きます。 [Repos] > [Pull requests] を選択して、PR を一覧表示します。 新しく開いた PR は、既定で [概要] タブになります。

2. PR の [概要] タブには、タイトル、説明、レビュー担当者、リンクされた作業項目、履歴、状態、コメントが表示されます。 PR の説明を読んで、提案された変更を確認します。 コメントを表示して、他のレビュー担当者が提起した問題を理解します。

   注意

   各ファイルでは、変更の数が推定され、名前の横に [+] 記号または [rename, edit] (名前変更、編集) ラベルでマークされます。 ファイルに 50% を超える変更がある場合は、"名前変更された" と見なされます。これは Git リポジトリの既定のしきい値であり、変更できません。

   

3. [ファイル] タブを選択して、PR のソース ブランチ内のすべてのコンテンツ変更をレビューします。 初期ビューには、すべてのファイル変更の概要ビューが表示されます。 ファイルの横にある [View] (表示) ボタンを選択すると、そのファイルの変更のみが表示されます。 ファイルが変更された場合は、[View] (表示) ボタンで差分ビューが開きます。 ファイルが追加または削除された場合は、[View] (表示) ボタンでコンテンツ ウィンドウが開きます。

   

   注意

   パフォーマンス上の理由から、概要ビューには、0.5 MB を超えるファイルの変更は表示されません。

4. ファイルの差分ビューでは、横並びまたはインライン差分レイアウトを選択できます。

   

   ヒント

   5 MB を超える "1 つ" のファイルの場合、差分ビューには切り捨てられたファイルの内容が表示されます。 完全なコンテンツを差分表示するには、ローカル差分ツールを使用して、このようなファイルをダウンロードしてレビューします。

   左側のファイル ツリーを使用して別のファイルを表示するか、ファイル ツリーのルートを選択してすべてのファイル変更の概要ビューを表示します。

5. ソース ブランチへの特定のプッシュによって導入された変更セットを確認するには、変更ドロップダウン リストから 1 つ以上の変更セットを選択します。 1 つ以上の変更セットを選択すると、差分ビューが更新され、選択した変更セットからの変更のみが表示されます。 この機能は、前回のレビュー以降に変更が PR にプッシュされ、新しい変更を確認するだけの場合に役立ちます。 変更ドロップダウン リストでは、各プッシュ操作の最後のコミットからのコミット メッセージによって各変更セットの名前が付けられます。

   

   ヒント

   変更ドロップダウン リストから複数の変更セットを選択するときは、Shift キーを押したままにします。

6. [更新] タブを選択して、プッシュされたすべての変更セットを表示して、ソース ブランチの変更を見逃していないことを確認します。 変更セットには番号が付き、最新の変更セットが一覧の上部に表示されます。 各変更セットには、プッシュ操作でプッシュされたコミットが表示されます。 強制プッシュされた変更セットでは変更セット履歴は上書きされず、他の変更セットと同じように変更セットの一覧に表示されます。

   

7. [コミット] タブを選択すると、ターゲット ブランチから分岐した後のソース ブランチのコミット履歴が表示されます。 PR の作成者が別のコミット履歴を強制プッシュすると、[コミット] タブのコミット履歴が上書きされるため、[コミット] タブに表示されるコミットが [更新] タブに表示されるコミットと異なる場合があります。

   

PR の状態を簡単に把握するために、PR の [概要] タブには、PR の成功または失敗に関するチェック、要件、ブランチ ポリシーがまとめられています。 場合によっては、状態チェックのログからのエラー メッセージのスニペットが概要に表示されます。 概要には失敗したポリシーのみが表示されますが、[View <n> checks] (<n> チェックの表示) を選択すると、すべての成功および失敗したポリシー チェックを表示できます。

PR の [概要] タブでは、PR の説明とコメントを確認して、提案された変更を理解し、他のレビュー担当者が提起した問題を確認できます。

PR の作成者とレビュー担当者は、PR コメントを追加して返信することで、相互にコミュニケーションを取ることができます。 PR をレビューするときは、コメントを使用します。提案された変更に関する問題を指摘し、変更を提案して、前のコメントに返信します。 正確でわかりやすい建設的なフィードバックを目指してください。 @username を使用して受信者を直接指定します。 #workitemID を使用して作業項目を参照し、!pullrequestID を使用して他の PR を参照します。 PR の作成者は、文書化の目的で自分自身にコメントを作成することがあります。

コメントでフィードバックを送信する

フィードバックがファイル内の特定の行または行範囲を対象としている場合は、ファイル内のその場所にコメントを追加します。

1. PR の [ファイル] タブで、コメントする行にカーソルを合わせ、コメント ボタン を選択してインライン コメント ボックスを開きます。 複数の行を選択し、それらの行にカーソルを合わせると表示されるコメント ボタンを選択することもできます。

   

2. コメント ボックスにコメントを入力し、[コメント] を選択します。

   

フィードバックがファイル全体を対象としている場合は、ファイルのオプション メニューから [コメントの追加] を選択して、ファイル レベルのコメントを追加します。

特定のファイルに関連しない一般的なフィードバックを提供するには、[概要] タブにコメントを追加します。

PR のレビュー担当者も、コメントを使用して、次のセクションで説明するように、特定のファイル行への変更を提案することができます。

コメントで変更を提案する

コメントを使用して、ファイル内の 1 行以上の置換テキストを提案できます。

1. PR の [ファイル] タブで、コメントする行にカーソルを合わせ、コメント ボタン を選択してインライン コメント ボックスを開きます。 複数の行を選択し、それらの行にカーソルを合わせると表示されるコメント ボタンを選択することもできます。 受け入れられた場合、提案されたコンテンツは、コメントが追加された行または複数行に置き換えられます。

   

2. コメント ボックスの下にある電球アイコンを選択して、フェンスされたコード ブロック内のコメント ボックスで提案する変更を作成し、[コメント] を選択します。 横並びの差分ビューの元のコード (左側) にコメントを追加しても、電球アイコンは表示されません。

   

PR の作成者は、次のようにして提案を受け入れます。

1. [変更の適用] を選択して、コミットの準備状況の変更をステージングします。

   

2. [すべての変更をコミットする] を選択して、ステージングされたすべての変更をコミットします。 PR の作成者は、[変更を元に戻す] を選択して、提案のステージングを解除できます。

   

コメントを編集または削除する

コメントにカーソルを合わせ、[編集] または [削除] の各アイコンを選択すると、コメントを編集または削除できます。

コメントに "いいね!" を付ける

PR の作成者とレビュー担当者は、コメントにカーソルを合わせ、サムズアップ アイコンを選択することで、自分や他のユーザーのコメントに "いいね!" を付けることができます。

"いいね!" が付いたコメントには、色が付いたサムズアップ アイコンと "いいね!" の数が表示されます。 サムズアップ アイコンの上にカーソルを合わせると、コメントに "いいね!" を付けたユーザーの一覧が表示されます。

コメントに返信する

PR の作成者はコメントに返信して、フィードバックや提案にどのように対処しているかをレビュー担当者に知らせる必要があります。

1. コメントに返信するには、[Write a reply] (応答をご記述ください) フィールドに応答を入力します。 @username を使用して受信者を直接指定します。 #workitemID を使用して作業項目を参照し、!pullrequestID を使用して他の PR を参照します。

   

2. 応答を入力した後、自分の応答が最終的な場合は [応答して解決]を選択します。 そうでない場合は、[Reply] (返信) を選択します。

   

   [応答して解決] を選択すると、コメントの状態が [解決済み] に変わります。 PR の作成者も、次のセクションで説明するように、コメントの状態を直接変更することができます。

コメントの状態を変更する

新しいコメントは、最初は [アクティブ] な状態になっています。これは PR の作成者によって、レビュー担当者のフィードバックや提案にどのように対処したかを示すために、レビュー プロセス中に更新されます。 PR の作成者は、状態ドロップダウン リストからコメントの状態を選択できます。

• [アクティブ]: 新しいコメントの既定の状態です。

• [保留中]: このコメントの問題はレビュー中であり、他の作業を待機しています。

• [解決済み]: このコメントの問題は対処済みです。

• [修正しない]: このコメントの問題は把握されていますが、修正されません。

• [終了]: このコメントのディスカッションは終了しています。

PR の作成者とレビュー担当者は、次のセクションで説明するように、コメントの状態をフィルター処理することで PR の進行状況を追跡できます。

PR にコメントを追加して、提案を行い、以前のコメントに返信し、提案された変更に関する問題を指摘します。

• PR の [ファイル] タブで、コメントする行にカーソルを合わせ、コメント ボタンを選択してインラインでコメントします。

  

• [概要] タブでコメントすることで、特定のコード行に関連付けられていないフィードバックを提供します。

• @username を使用して、コメント内の作成者または他のレビュー担当者を直接指定し、#workitemID を使用して作業項目を参照します。 !pullrequestID を使用して他の PR を参照することもできます。

コメントの編集、削除、または "いいね!"

コメントを編集または削除するには、コメントにカーソルを合わせ、鉛筆アイコンを選択してコメントを編集するか、ごみ箱アイコンを選択してコメントを削除します。

自分や他のユーザーのコメントに "いいね!" を付けるには、コメントにカーソルを合わせ、サムズアップ アイコンを選択します。 "いいね!" が付いたコメントは、色が付いたサムズアップ アイコンと "いいね!" の数がコメントの一覧に表示されます。 アイコンの上にカーソルを合わせると、コメントに "いいね!" を付けたユーザーの一覧が表示されます。

コメントに "いいね!" を付ける

自分や他のユーザーが作成したコメントに "いいね!" を付けるには、ハート アイコンを選択します。 コメントのアイコンの上にカーソルを合わせると、コメントに "いいね!" を付けたユーザーの一覧が表示されます。

コメント フィルター ドロップダウン リストからフィルター オプションを選択すると、[概要] タブに表示するコメントまたは更新を選択できます。 たとえば、PR を最後に開いた後の新しいコメントと更新を表示するには、[What's new] (最新情報) フィルター オプションを選択します。 各フィルター オプションには、そのカテゴリの項目の数が表示されます。

[概要] タブに表示するコメントと更新を選択できます。コードを初めてレビューするときは、一部のコメントと更新を非表示にして、邪魔にならないようにします。 PR に最後にアクセスしてからの最新情報のみを表示することもできます。

コメントと更新をフィルター処理するには、コメントの一覧の上部にある [Show everything (n)] (すべて表示 (n)) ボタンを選択し、フィルター オプションのいずれかを選択します。 ビューが変更され、選択したコメントと更新のみが表示されます。 ボタンのラベルが変更され、フィルター条件と表示される項目の数が表示されます。

コメントに対処する

Web 上のコードの [ファイル] タブからブランチを直接簡単に更新できます。

コメントに返信して解決する

コメントに返信し、コメントの状態を更新して、コメントや提案にどのように対処したかをレビュー担当者に知らせます。

• 返信せずにコメントを解決するには、コメントの下にある [Resolve] (解決) を選択します。
• コメントに返信するには、[Write a reply] (応答をご記述ください) フィールドに応答を入力して、[Reply] (返信) を選択します。
• コメントに返信して解決するには、[応答をご記述ください] フィールドに応答を入力して、[応答して解決] を選択します。
• 返信で @username を使用して特定のレビュー担当者に返信し、#workitemID を使用して作業項目を参照します。 !pullrequestID を使用して他の PR を参照することもできます。

新しいコメントは [アクティブ] 状態で開始されます。 [解決] または [応答して解決] を選択して、コメントの状態を [解決済み] に更新します。

コメント解決ドロップダウン リストでは、その他のオプションを使用できます。

• [アクティブ]: コメントはまだレビュー段階です。
• [保留中]: このコメントの問題は対処される予定ですが、まだ修正されていません。
• [解決済み]: このコメントで提起された問題は修正済みです。
• [修正しない]: コメント内の提案は把握されていますが、この PR では対処されません。
• [終了]: このコメントのディスカッションは終了しています。

既にレビューされているファイルを引き続き追跡するには、PR のファイルの横にある [その他のオプション] を選択し、[レビュー済みとしてマーク] を選択します。

ファイルを編集する

利便性のため、PR の作成者は Azure Repos で直接ファイルを編集できます。 たとえば、レビュー担当者によって提案されたコード変更を受け入れ、他の場所で同様の変更を行いたいとします。

1. [Repos] > [Files] (ファイル) を選択し、PR のソース ブランチを選択し、ファイルを選択して、[編集] を選択します。

   

2. エディターで変更を行い、[コミット] を選択して [コミット] ダイアログを開きます。

   

3. コミット ダイアログで、必要に応じてコミット メッセージを編集し、コミット を選択して変更をコミットし、PR にプッシュします。

   

レビュー済みファイルを追跡する

PR のレビュー担当者は、ファイル オプション メニューから [レビュー済みとしてマーク] を選択するか、ファイルまたはフォルダーの横にあるチェック ボックスをオンにすることで、レビュー済みファイルを引き続き追跡できます。

PR を完了する

PR の作成者は、PR 解決オプションを選択できます。

• [完]了: すべての必須のレビュー担当者が承認し、必要なすべてのブランチ ポリシーが満たされている場合、PR を今すぐ完了します。

• [オートコンプリートの設定]: すべての必須のレビュー担当者が承認し、必要なすべてのブランチ ポリシーが満たされたときに、PR をオートコンプリートします。

• [ドラフトとしてマーク]: PR をドラフトの状態に設定して、レビューの準備ができていないことを示します。 ドラフト PR の場合は、[公開する] を選択してドラフトの状態を削除し、レビュー準備完了とマークできます。

• [Abandon] (破棄): PR を閉じます。 破棄された PR の場合は、[Reactivate] (再アクティブ化) を選択して復元できます。

PR の完了の詳細については、pull request の完了に関するページを参照してください。