少し前に読んだ「情熱プログラマ」では、プログラマの必須能力のひとつとして 作文技術 を挙げており、とても納得しました。 優れたプログラムは、ムダが少ないためにわかりやすく、そのうえ見た目にも美しいものです。 これに対し、良くないコードは読みにくく、把握が困難なために見ているだけでイライラしてきます。 そして、コードの良さはコメントひとつにもあらわれるものです。 今回はアンチパターンとして私が「 ないわー 」と思ったコメントの付け方をピックアップしてみます。 ノイズになっているコメント 良くないコメントの 9割 はノイズである by Atuweb コードをそのまま自然言語に直しただけのコメント 1// Bad: コードをそのまま自然言語に直しただけのコメント 2var $_item_id;//アイテムID 3var $_loginid;//ログインID 4var $_pass;//パスワード
![[プログラミング]そのコメント、カッコ悪い – atuweb 開発ブログ](https://cdn-ak-scissors.b.st-hatena.com/image/square/f4259bb1caff2a05cd30a821e3633cf810b2193e/height=288;version=1;width=512/https%3A%2F%2Fatuweb.info%2Fimages%2Feyecatches%2Feditor_lg.png)