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

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

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

また、個々の行 またはファイル コメントの形式で、またはプル要求の [ファイル変更 ] タブにあるファイルの特定の ファイルまたは セクションにコメントを付けることもできます。 行 またはファイル コメントを追加するのは、実装に関する疑問点の議論や、作者へのフィードバックを行うのに非常に便利な方法です。 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 での執筆」