[GitHub 100日チャレンジ] Day 80 - コードレビュー文化を作る
GitHub Pull Requestのレビューを通じて、品質を上げながらチームの学習が進むコードレビュー文化を作る考え方を学びます。
[GitHub 100日チャレンジ] Day 80 - コードレビュー文化を作る
コードレビューの目的
コードレビューは、間違い探しだけではありません。品質を上げ、知識を共有し、チームの判断基準をそろえるための時間です。
良いレビューコメント
良いコメントは、問題点だけでなく理由と代案を含みます。
1
2
この条件だとnullのときに例外になります。
先にguard clauseを置くと読みやすくなりそうです。
命令ではなく、改善の意図が伝わる書き方にすると会話が続きやすくなります。
PRを小さくする
大きすぎるPRはレビューが難しくなります。できるだけ1つの目的に絞ります。
- 変更範囲を小さくする
- テスト結果を書く
- スクリーンショットを添える
- 迷った点を先に書く
今日のゴール
レビュー文化はツールだけでは作れません。小さなPR、具体的な説明、敬意あるコメントを積み重ねて、学習できるレビューにしましょう。
この投稿は投稿者によって CC BY 4.0 の下でライセンスされています。
