from 2023/2/15

これは良いやり方があって、どっかで仕入れたプラクティスだけど、コメントの頭にコメントの目的を書く

[fix] 直したほうが良い、直してほしい

[ask] レビューをするのに理解や知識が足りない気がするので教えてほしい(a.k.a. 純粋な質問(？))

[imo] いろんな観点あるけど、私の考えはこうです

みたいな、褒めでも使える

レビューのコメントはだいたいこの3つに分類できるはず。あとは [nit] (細かいんだけど~)も使うかも。で、自分はこのフォーマットでレビューするというのを周りに周知(レビューコメントで上記の説明書けば十分)しておけば、ある種のプロトコルっぽくなって、書かれていないことを読んでしまう人間味のある深読みの危険性が減ると思う。トゥゲッタにまとめられてるツイットにもあるけど、「純粋な質問なんですが」は、「純粋ではない質問」の存在を暗示していて良くない。質問は質問、純も不純もない。