設計書（システムの文書）

システムの文書には、要件定義書、基本設計書（画面・帳票・データ・外部とのつながりなど）、詳細設計書、テストの計画と結果、運用の手順書などがあります。どの文書をどこまで作るかは、システムの大きさ、開発の進め方、保守を誰が行うかによって変わります。

文書が残っていないと、仕様を変えるときや不具合を直すときに、ソースコードを読み解く手間がかかり、担当が替わったときの引き継ぎも難しくなります。アジャイル開発のように文書を少なくする進め方でも、保守に要る情報は残しておく必要があります。

発注する側は、納品物にどの文書を含めるか、文書の形式と最新に保つ責任を誰が持つかを、契約や要件で決めておきます。プログラムを直したときに文書も直す決まりにしないと、文書と実際のシステムがずれていきます。