ソースコードがドキュメント足りえないのは訓練していないから - イトウ アスカ blog

「ドキュメントはソースコードです」というのはよく聞く話です。しかし、実際の現場ではそれが通用することはあまりないでしょう。しかしながら、「そんな動きはソースを読まなきゃわからんよ！」なんてことが必ずあるはず。 では、なぜソースコードがドキュメントというのが通用しないのでしょうか？ それは、ドキュメントは日本語さえわかれば読める（気がする）のに対して、ソースコードはプログラミング言語がわからなければ読めないということもあるでしょう。 ですが私はこうも考えます。 プログラム言語さえわかれば、ソースコードも立派なドキュメントといいたくなるようなソースコードを書く人もいるのです。 それは、かなりベテランのプログラマです。歳は関係ありません。如何にソースコードをわかり易く書くかを常に考え、コーディングしてコーディングしてコーディングしまくったようなプログラマこそがそのようなプログラマになれるのです。

[lieutar]

エスイーでもせめて仕様を語るのはUMLとかでしてほしいなと. 俺様流儀の図がExcelで踊るのはもう勘弁

[RanTairyu]

[]「　いっぽう、ベテランプログラマは、仕様書を一度そしゃくします。そしてわかり易いソースコードになるよう」