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

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

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

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

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

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

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

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

   

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

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

   

4. コメントを追加するコード行にカーソルを合わせ、青いコメント アイコンをクリックします。

   

5. 必要に応じて、複数行にコメントを追加できます。 コメントする最初の行の行番号をクリックし、下にドラッグして行の範囲を選択し、コメントする最後の行の青いコメント アイコンをクリックします。 または、コメントする最初の行の横にある青いコメント アイコンをクリックし、コメントする最後の行まで下にドラッグします。

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

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

   

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

   

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

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

会話を解決する

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

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

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

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

会話の発見とアクセス

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

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

参考資料

• 「GitHub での執筆」- 「悪用あるいはスパムをレポートする」