れ： レビューは、考えを持ち寄る場。
この言葉の意味
コードレビューは、書いた人を採点する場ではありません。変更が目的を満たすか、読み手が理解できるか、問題が起こる条件はないかを一緒に確かめます。提案するときは理由を添え、必須の修正と好みの違いを分けると、話し合いが進めやすくなります。
たとえば、こんな場面で
理解を助けるための仮の場面です。
よくある場面
レビューで好みの書き方だけを押し付けると、目的や不具合の可能性が議論されず、作者も何を直すべきか迷うことがあります。
こう変えてみる
まず目的と制約を読み、正しさ・保守・利用者への影響を確認します。必須の修正と提案を分け、理由と例を添えて判断できるコメントにします。
自分に問いかける
その指摘は、誰のどんな困り事を減らすためですか。
今日の実践ヒント
次のレビューでは、気になった箇所と、その理由や起こりうる困り事をセットで伝えましょう。