#97prog_ja 60 真実を語るのはコードのみ

プログラマが知るべき97のこと

そのとおりだと思った。
結局実行されるのはソースコードのみ。
間違ってもソースコード内のコメントは実行されないし、
ドキュメントが実行されるわけじゃない。
人の言葉がそのまま実行されるわけでもない。

もしドキュメントが存在しないのであれば「今あるソースコードが全てを物語っている」という表現は正しい。

真実を語る存在だからこそソースコードは読みやすく、保守(リファクタリング)しやすくする必要がある。