オチョー ドキュメントの役割

ソフトウェア開発において断定しにくい問題としてドキュメントをどうするかということがあります。ドキュメントに関してはおおよそソフトウェア開発を仕事としている人すべてが何らかの形で考えざるを得ない問題です。 日経ソフトウェアに「俊敏な開発のためのプログラミング 悪徳の栄え」というYugui(園田裕貴)さんが書かれているコラムがあります。普段、断定しにくいことに関して一旦断定することによって問題をはっきり見えるようにしようという趣旨のコラムだと個人的には解釈しています。第５回のコラムには以下のように書かれていました。 プログラムの仕様書はテスト・コードとして書くべきです。そうすればより精密に記述できますし、いつでも自動化されたテストによって検証可能になるからです。仕様書を自然言語で書いたとしても、それは「自動実行できないテスト・コード」かそれ以下のものでしかありません。逆にテスト・コードは、その

[yugui]

どうにか、うまく伝わったようでよかった。 「指定のポートから1kHzの方形波を出力すること」って反例はいいな。