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 をつくる
  • レビューのコメントに対応する