コメントについて

プログラムの可読性を高めるコメントの書き方や、よく見かける不適切なコメントについて

プログラムの翻訳コメントは要らない

プログラムをそのまま日本語に訳したようなコメントは無意味です。

処理の内容をそのままコメントに書いても、後から読むときに何の助けにもなりません。

例えば、このサンプルのコメントは一見丁寧に書かれているように見えますが、よく見ると、プログラムを読めばすぐ分かることしか書かれていません。