■ソースより詳細設計書が良い場合もある

http://anond.hatelabo.jp/20161105155342

「ソースなりドキュメントください」って時は、その対象のアプリなりシステムの正しい仕様や挙動を知りたいときかなと思う。

俺は開発者の端くれだけど、ソース（コード）から正しい状態を把握できるだろう、ってのは感覚的にわかる。

だけど、そうならないときもままある。例えば次のようなとき。

・コードが複数の人間によって書かれていて、各人の実装レベル（技術力）に差がありすぎるとき

　大きなプロジェクトだと必然的に少人数じゃ書けないし、コードレビュアーもばらける。

　すると「これ同じ言語なのになんでこんなに違うんだよ！」っていう謎実装が入っていたりして

　コードから仕様を推測するのがと〜〜〜っても難しくなったり。

・ソフトウェアにバグはつきものだから

　リーダー1人が見渡せる規模ならバグ0も目指せるけど、大きくなればなるほどバグ減らないよね。

　実装者以外がバグ入りのコードを見ても、それがバグなのか判断付かないから、間違った仕様を正しい仕様として

　理解しちゃうリスクがある。　

もちろんドキュメント（仕様書）にだって間違いが書かれることもあると思うよ。

関わる人数が増えれば増えるほど、間違い・バグの混入率は上がるからね。

でも関わる人数的な話なら、多くの場合（設計書を書く人 ＜ 実装する人）になると思う。なので、対象となるアプリ・システムが

大きくなればなるほど、ドキュメントを正としていくしかないんじゃないかなーと。

Permalink | 記事への反応(1) | 22:56

ツイートシェア