🐙

GitHub の PR で編集されていない箇所にレビューコメントしたかった

2024/04/24に公開

概要

GitHub の PR で編集されていない箇所にレビューコメントしたかったのですが、どうしてもできなかったため代替策を記録しておきます。

課題

GitHub で コードレビューをしていると、その PR 内で編集されていない箇所にコメントしたいことがあります。ですが PR では編集された近辺の行にしかコメントを追加できません。

alt
コード編集箇所とその近辺では、青い+マークが表示される

alt
+マークをクリックし、コメントを追加する

alt
しかし編集箇所ではないところには+マークが表示されずコメントできない

対策

基本

この場合、PR のコード内に直接コメントをできる方法はありません。そのため以下の代替手順でコメントを残すことにしました。

  1. View File を選択してファイルを開く
  2. 該当する行を選択して Copy permalink をクリック
  3. Conversation にコピーした URL を含めてコメント
  4. Request changes にコメントを書いて Submit review をクリック

alt
View File を選択してファイルを開く

alt
該当する行を選択して Copy permalink をクリック

alt
Conversation にコピーした URL を含めてコメント

alt
Conversation にコピーした URL を含めてコメント

alt
Request changes にコメントを書いて Submit review をクリック(自作自演 PR のため Request changes にチェックが入れられず)

レンダリングされるファイルの場合

Markdown や CSV などレンダリング表示されるファイルの場合、Copy permalink が選択できない場合があります。この場合はコード表示に切り替えることで同様の操作が可能です。

alt
Markdown では Copy permalink などのメニューが表示されない

alt
Code ボタンを押す事でコード表示に

Code ボタンがない場合

「私の画面ではそんなボタンがない!」という方がいるかもしれません。もしかするとご所属の会社は GitHub Enterprise Server(自己ホスト型)をご利用なのかもしれません。その場合は以下のボタンを押してみてください。

alt
Display the source blob を押すことでコード表示に

まとめ

どの箇所をどのように直すべきか一目でわかるようにしてあげる事で、レビュアー/レビュイー間の齟齬がなくなり結果的に早く仕事が進みます。良いコードレビューを!

GitHubで編集を提案

Discussion