Skip to main content

プルリクエストへのコメント

リポジトリのプルリクエストのオープン後、コラボレーターや Team メンバーは、特定の 2 つのブランチ間におけるファイルの比較について、またプロジェクト全体についてコメントできます。

プルリクエストのコメントについて

pull request の [Conversation](会話) タブには、一般的なコメント、質問、提案などを書き込むことができます。 プルリクエストの作者がコメントから直接適用できる変更を提案することもできます。

また、個々の行 またはファイル コメントの形式で、またはプル要求の [ファイル変更 ] タブにあるファイルの特定の ファイルまたは セクションにコメントを付けることもできます。 行 またはファイル コメントを追加するのは、実装に関する疑問点の議論や、作者へのフィードバックを行うのに非常に便利な方法です。 プル リクエストの詳細については、「プルリクエストのレビューについて」を参照してください。

行 またはファイル コメントを pull request レビューに追加する方法の詳細については、「プルリクエストで提案された変更をレビューする」を参照してください。

注: pull request に対してメールで返信する場合、コメントは、pull request レビューの一部としてではなく、 [Conversation](会話) タブに追加されます。

既存の行コメントに返信するには、 [Conversation] タブまたは [Files changed]タブのいずれかでコメントに移動して、その下に追加の行コメントを追加します。

ヒント:

  • pull request のコメントは、GitHub のコメントと同じフォーマット (@mentions、絵文字、参照など) をサポートしています。
  • pull request 内のコメントに対する反応は、 [Files changed](変更したファイル) タブに追加できます。

プルリクエストに行コメントを追加

  1. リポジトリ名の下にある [pull request] をクリックします。

    リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、[pull request] というラベルが付いたタブが濃いオレンジ色の枠線で囲まれています。

  2. プルリクエストのリストで、行コメントをしたいプルリクエストをクリックします。

  3. pull request で、 [変更されたファイル] をクリックします。

    pull request のタブのスクリーンショット。 [変更されたファイル] タブが濃いオレンジ色の枠線で囲まれています。

  4. コメントを追加するコード行にカーソルを合わせ、青いコメント アイコンをクリックします。 複数行にコメントを追加するには、クリックしてドラッグして行の範囲を選択し、青いコメント アイコンをクリックします。

    pull request の差分のスクリーンショット。 行番号の横に、青いプラス アイコンがオレンジ色の枠線で強調表示されています。

  5. コメントフィールドにコメントを入力してください。

  6. 必要に応じて、1 つまたは複数の行に固有の変更を提案するには、 をクリックした後、提案ブロック内のテキストを編集します。

    レビュー コメント ボックスのスクリーンショット。 特定の変更を提案するファイル差分アイコンが、濃いオレンジ色の枠線で囲まれています。

  7. ファイルに直接コメントするには、ファイルの右側にある をクリックしてコメントを入力します。

    pull request の [変更されたファイル] ページの画像ファイルのスクリーンショット。 画像ファイルの右側に、コメント アイコンがオレンジ色の枠線で強調表示されています。

  8. 完了したら、 [Add single comment](1 つのコメントの追加) をクリックします。

プルリクエストまたはリポジトリを Watch している全員が、コメントの通知を受信します。

会話を解決する

プルリクエストをオープンしたり、プルリクエストがオープンされたリポジトリへの書き込みアクセス権を持っていたりすれば、プルリクエスト中の会話を解決できます。

[変更されたファイル] タブの会話が完了したことを示すには、 [会話の解決] をクリックします。

会話全体が畳まれ、解決のマークが付きます。これで、まだ対応が必要な会話を見つけやすくなります。

コメントの示唆がプルリクエストの範囲を超えているなら、そのコメントへのフィードバックやリンクを追跡する新しいIssueをオープンできます。 詳しくは、「Issue の作成」を参照してください。

会話の発見とアクセス

[変更されたファイル] タブの上部に表示される [会話] メニューを使用すると、pull request 内のすべての会話を検出して移動できます。

このビューから、未解決の会話、解決済みの会話、古くなった会話を見分けることができます。 これによって、会話を見つけて解決することが容易になります。

pull request の [変更されたファイル] タブの [会話] メニューのスクリーンショット。

参考資料