コメントは基礎的で一般的なものでありながら、「どのようなことをコメントに残すか」は経験のあるプログラマにとっても難しいもの。 この記事では、アンチパターンコメントを見ながら、どのようなコメントを残すべきかについて説明します。 by 馬場美由紀 (CodeIQ中の人) コードは機械のために、コメントは人間のために? プログラミング言語を学ぶとき、コメントは最初に習う項目のひとつです。そして、プログラムであればコメントを含んでいることが普通です。ある研究によれば、ソースコードの平均19%がコメントだそうです。 コードを書くとき、私たちは機械とコミュニケーションを取ることを意識しています。機械はコードを認識してコンパイルしたり実行してくれます。解釈できなければ教えてくれます。プログラマは、コンパイラのためにデータ型を明示するコードを書いたりもします。 一方、コメントは人間とコミュニケーションする
![コメントの9割は無駄!~アンチプラクティスから学ぶ洗練されたコメントの書き方~ #code #コード|CodeIQ MAGAZINE](https://cdn-ak-scissors.b.st-hatena.com/image/square/42b8204248cdc18e3f19d786a33d821f1ff5e00d/height=288;version=1;width=512/https%3A%2F%2Fciq-prod-magazine-resources.s3-ap-northeast-1.amazonaws.com%2Fmagazine%2Fwp-content%2Fuploads%2F2013%2F12%2F882b2a45ec56c96ad4f648db850fb08d1.gif)