キレイなコードでも仕様書の代わりにはならない - 設計者の発言

４ＧＬ（第四世代言語。既に死語）を使っていた頃に「ソースコードが仕様書だ」と言い張っていたことがある。テーブル操作コマンドと統合されているそのプログラミング言語を使えば、じっさい英語の文章のように明解にコーディングできた。しかしそんな強力な言語を前提にしても、今から考えれば「コードが仕様書だ」と主張したのは間違いだった。 理由は単純。仕様書として通用するほどキレイにコーディングが可能と謳われている言語を使ったとしても、コーディングがキレイになることが「保証」されているわけではないからだ。まあ当然のことで、文章の読みやすさが書き手によってまるで違うのと同様、コードの読みやすさはプログラマによってまるで違う（その日の気分や体調によっても違うかもしれない）。いかに標準化を徹底しようが、同じ動きをするのにいっぽうは読みやすくいっぽうはわけがわからないなんて事態は日常的に起こる。そして、システム開発

[ryoasai]

仕様書の内容にもよるが、自動生成ツールの議論をしているあたり、ちょっと納得ができない。リファクタリングを考慮していない。

[masatosi0]

Cのソースコードからリバースするのはシンドかったなあ

[katzchang]

「仕様書でシステムが動くことの爽快さを実感してほしい」システムを動かすドキュメントは、もうコードと呼んでもいいような。

[zorio]

「読みにくいコードよりは読みにくい仕様書のほうが、様式化の度合いの高さゆえに「プログラムの意匠や意図」がわかりやすい」のかどうか、よく分からない。

[chintaro3]

がんばれ