全体の概要とか外部仕様、内部仕様を区別せず、
一口にドキュメントの是非を問うから議論が分かれる気が。

>>403 が言うとおり、
システム全体像・外部仕様はしっかり、
内部仕様はソースが正、doxygen とかで自動生成
って言えば、あんまり反対する人いないと思うんだけど。