Google Engineering Practices Documentation
Google がこれまで蓄積してきた開発に関する知識、経験、手法を公開した。
Google Engineering Practices Documentation | eng-practices
非公式だが、日本語翻訳されたドキュメントも存在する。
Google エンジニアリング・プラクティス ドキュメント | eng-practices
現在はコードレビューに関するドキュメントがある。
ひとつはコードレビューをする側のドキュメント。
How to do a code review | eng-practices
ここでは以下が取り上げられている
- コードレビューの基準
- コードレビューで何を探すべきか
- レビュー中のCLのナビゲート
- コードレビューの速度
- コードレビューコメントの書き方
- コードレビューでのプッシュバックの処理
CL というのは Change List の略である。変更セットやパッチ、などのコードレビューをする単位。
もうひとつは、CL を作る側、コードレビューを受ける側のためのドキュメントである。
The CL author’s guide to getting through code review | eng-practices
これには下が含まれる
- 良い CL の説明を書く
- 小さな CL をつくる
- レビューのコメントに対応する