某氏……に限らず，巷でドキュメンテーションを嫌がっている向きが典型的に口にすることに，次のような話があります。 以前もこの話を書いたかもしれないけれど，この命題は非常にトリッキーで詭弁的だと思っています。確かにソースコードにはバグも含めてすべてが書かれている。これは間違いありません。 しかし，ソースコードにバグが書かれていることが分かっていたとして，これは開発で必要な情報となりうるのでしょうか。あたしには，意味のない情報としか思えません。というのも，開発に必要なバグに関する情報は，「バグが書かれているか」ではなく「何がバグでソースコード上どう実装されているか」に尽きるからです。 そもそも，プログラムはプログラムした通りにしか動かないのだから，プログラム（ソースコード）の内部に「バグ」という概念はありません。通常，バグは開発者/設計者/ユーザが意図した通りにプログラムが動かないこと言います。