システム開発プロジェクトを遂行する中で作成される各種ドキュメントの品質を担保するために、レビューは欠かせません。正しいレビューを行うためにも、レビューの手順を理解しておきましょう。

別記事ドキュメントレビューのポイント vol.2 〜レビューの準備〜では、レビューは「4つのステップ」で実行されるということをご紹介しましたが、本記事では前述の別記事でご紹介した「1.レビューの準備」のうち、レビュアーが準備段階で実施するタスクを詳細に確認していきます。

多くのシステム開発プロジェクトの現場では、レビュアーは他業務をこなしながらレビューを担当しています。レビューを効率的に進めつつ、重大な問題を見落とさないようにするには、レビュアーも事前準備をしっかりと行い、レビューに備える必要があります。

レビュアーの準備タスク

下記の4つのタスクがあります。

1. シナリオの順序検討

シナリオが未作成の場合は、シナリオを作成します。すでにシナリオが作成されている場合は、自身にアサインされたシナリオの内容を参照し、シナリオの優先度や重要度を検討していきます。レビュー対象ドキュメントに「漏れ」「曖昧さ」「誤り」がないか、順にチェックをしていくわけですが、手当たり次第にレビューを行ってはいけません。レビューにおいて重大な問題を効率的に検出するために、シナリオの順序は重要なのです。

2. 情報整理

シナリオの内容から、レビュー対象のドキュメントに書いてあるべき内容がどんなものか、想定します。事前に想定ができていないと、誤字脱字や体裁（フォント、表組、等）のなどの些細な誤りに気を取られ、本来検出すべき重大な問題を見逃してしまう可能性があります。

また、レビューに必要なドキュメントを全て揃えておくことも重要です。レビュー対象ドキュメントを読み始めてから、関連する参照ドキュメントが手元にないことに気づくと、そのドキュメントを探すための工数が余分にかかってしまいますし、チェックする集中力が途切れてしまいます。スムーズにレビューを進めていくために、レビュー対象のドキュメントに関連して必要となる参照ドキュメント類をあらかじめ手元に揃えておく必要があります。

3. 検出方法の検討

次に、レビュー対象ドキュメントの内容の「漏れ」「曖昧さ」「誤り」を見逃さずに検出できるよう、ドキュメントのどの箇所をチェックしていくのか、具体的な方法を検討します。

チェック対象箇所を絞らずにレビューを行ってしまうと、ドキュメントの前半部分を集中してチェックしがちで、そのために後半のチェックが甘くなってしまうことがあります。

4. 実施タイミングの検討

レビューの時間をまとめてとって実施するケースと、レビュアーが作業の合間に個別にレビューを進めて行くケースがあります。プロジェクトの進捗状況にもよりますが、レビュアーがレビューを後回しにしてしまいチェックが疎かにならないよう、レビューするシナリオごとにどのような進め方が適しているか、判断していく必要があります。

まとめ

レビューを効率的かつ着実に進めていくためには、準備段階におけるタスクを理解し、準備をしっかりとしておく必要があります。レビュー対象ドキュメントをチェックし、重大な問題を検出できるよう、レビュアーとしての準備もしっかりと進めたいですね。

■ドキュメントレビューに関するその他の解説記事

ドキュメントレビューのポイント vol.1 〜レビューの間違い〜
ドキュメントレビューのポイント vol.2 〜レビューの準備〜
ドキュメントレビューのポイント vol.3 〜レビュアーの準備〜 【本記事】
ドキュメントレビューのポイント vol.4 〜ドキュメントレビューの実施〜

【参考文献】
間違いだらけの設計レビュー [改訂版]　日経BP社