/note/tech

ドキュメントレビューをする際の10のポイント

  • 1. 体裁をレビューするのではなく、中身をレビューする
  • 2. 標準化ではなく、顧客や案件ごとに最適化できるような自由度をチームに与える
  • 3. レビューの目的を明確にする
  • 4. 大がかりなレビューを少ない回数実施するのではなく、こまめな小規模レビューを繰り返す
  • 5. レビューでの指摘事項をすべて対応しなければならないとは限らない。チームにとって労力をかけるだけのメリットがあるものから優先順位付けをして実施する
  • 6. レビューで人格を非難しない
  • 7. レビューの順番もレビュー効果が高いものから実施すること
  • 8. 機械的に検証可能なドキュメントのレビューは自動化すること
  • 9. レビューワーも技術もしくは顧客の業務をしっていること
  • 10. レビュー結果はチーム内外含めて共有すること