開発現場は日々の仕事の場であるとともに、学びの場でもある。先輩エンジニアが過去に直面した困難の数々、そこから学んだスキルや考え方を紹介する。 前回「本当は楽しいドキュメント作成」に引き続き、システム開発プロジェクトで作成される文書にフォーカスします。 今回は基本設計文書について考えたいと思います。なお、以下の内容は筆者の私見であることをあらかじめお断りしておきます。 基本設計文書の品質を下げる要素とは 基本設計工程では、文書作りに対して、その完成度を下げるための「負の心理バイアス」がかかると考えています。文書作りの際、文書の量と質を下げようとする意識が働くのではないかということです。 基本設計文書の完成度を下げる「負の心理バイアス」にはさまざまなものがあります。わたしは、下記の4つが代表的なものだと考えています。 ユーザーとの検討に関するバイアス 開発手順に関するバイアス 文書用途の理解不