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

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

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

pull request の [Files changed] タブにある特定のファイルやファイルのセクションについて、個別の行やファイルのコメントの形式で、または pull request レビューの一部として、コメントすることもできます。 行またはファイルのコメントを追加することは、インプリメンテーションについての問題についてディスカッションしたり、作者にフィードバックを行ったりする上でよい方法です。 pull request のレビューについて詳しくは、「AUTOTITLE」を参照してください。

pull request レビューへの行またはファイルのコメントの追加に関する詳細については、「AUTOTITLE」を参照してください。

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

pull request にコメントを追加する

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

   

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

3. Pull request で、[ Files changed] をクリックします。

   
   1. コメントを追加するコード行にカーソルを合わせ、青いコメント アイコンをクリックします。
   
   1. 必要に応じて、複数行にコメントを追加できます。 行の範囲を選択するには、コメントする最初の行の行番号をクリックし、最後の行までドラッグするか、 Shift キー を押しながら最後の行番号をクリックします。 その後、コメントする最後の行の青いコメント アイコンをクリックできます。 または、コメントする最初の行の横にある青いコメント アイコンをクリックし、コメントする最後の行まで下にドラッグします。1. コメントフィールドにコメントを入力してください。1. 必要に応じて、1 つまたは複数の行に固有の変更を提案するには、 をクリックした後、提案ブロック内のテキストを編集します。
   
   1. ファイルに直接コメントするには、ファイルの右側にある をクリックしてコメントを入力します。
   

4. 完了したら、次のようにします。

   • この 1 つのコメントのみを追加する場合は、[Add single comment] をクリックします。

   • 複数のコメントを追加する場合は、[Start a review] をクリックして、コメントの追加を続けます。

     追加し終わったら、ページの右上にある [Finish your review] をクリックし、レビューの要約はそのままにして、[Submit review] をクリックします。

pull request またはリポジトリを Watch している全員が、コメントの通知を受信します。 コメントをバッチ処理すると、通知が複数送信されるのを回避できます。

会話を解決する

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

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

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

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

会話の発見とアクセス

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

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

参考資料

• AUTOTITLE