10年間ソフトウェア開発に携わってきて学んだひとつのこと。

2001年にメーカ系システム開発会社に転職しました。
約10年間、半導体製造装置のひとつの製品に携わってきました。
今年度から別の部署に異動することになりました。

そこでいろいろなことを学ばせていただいた中で
ひとつだけ記しておきたいと思います。

コンテキストはこんなかんじです。
・メーカ系ソフトウェアエンジニア
・開発システム半導体製造装置
・システム開発部署、仕様書作成部署、ハードウェア部署のセクションがある
・システム開発部署は20〜30名

システム部署の仕事とは

システム開発部署は、仕様書作成部署の設計仕様書とハードウェア部署の
ハードウェア仕様に沿ってプログラムを作成する部署と理解されている方が多いと思います。

また、きちんとした設計仕様書から正しい概要設計書、基本設計書を
作成すれば、よい品質のプログラムができると考える方も多いと思います。

しかし、概要設計書、基本設計書があれば誰でも同じ品質のプログラム
ができるかというとそうではありません。

それは、設計書からソースコードにする方法（実装）には
いくつか選択肢があり、その時点で必ずしも良い選択ができるとは限らないからです。
では設計書にもれなく記載すれば良いのでしょうか？

より良い設計を求めて

設計書は、書かれた時点の設計情報が記述されます。
それはその時点のものです。いわばスナップショットです。
もれなく詳細に記述すればするほど設計書の"賞味期限"は短くなっていきます。
また、設計初期の早い段階で詳細まで決定してしまうことは、良いアイデア
を制限してしまい改良の余地が少なくなります。
さらに要求自体が変化したり追加されたりといったことも発生します。

もし完全な（ここでいう完全とはプログラムをこうつくって欲しいという
設計情報がもれなく記載されたもの）設計書というものがあるとすれば
それは MS-WORD で日本語で書かれた文書ではなく、ソースコードそのものになります。