「なぜここで1を加算してるんでしょうか?」
とか、
「シャドーイングってご存じですか?」
みたいなコードレビューコメントって、純粋な質問であっても受け取り方によっては詰問してるように聞こえたり、嫌味を言ってるように聞こえたりするので、テキストコミュニケーションって難しい。
コードレビューにおいて疑問文が詰問に聞こえちゃうパターンなので「純粋に質問」を冒頭に付けてみた。
「なんでtrueにしたんですか?」が「普通はやらないでしょ!💢」に聞こえてしまう日本語の難しさよ……。
「テキストから相手の意図や人格を推察するのをやめればよい(書いてある事のみに反応しろ)」みたいな事を言う人もいるけど、その場合、「質問の意味がわかりません」「はい/いいえ」みたいな回答になってコミュニケーションコストが異様に上がってしまう問題がある。
結局、スムーズにコミュニケーションを取るには、ある程度相手の意図や疑問点を慮っていく必要はある。
自分の場合は「このようにしている意図はなんですか?自分は〜のような問題を生じる可能性がありそうだと考えました」みたいな言い回しをすることが多い。