開発者向けQ&Aサイト「Stack Overflow」は2021年12月23日(米国時間)、コードコメントを書くためのベストプラクティスを紹介した。これはミルズ大学のコンピュータサイエンスの教授であるエレン・スパータス氏による寄稿記事だ。 この記事は2021年7月5日に掲載されたもので、同ブログで2021年に人気を博した記事のトップ10の1つとして再掲載された。 スパータス氏は、「コメントは、出来の悪いコードの言い訳や修正として書くものではなく、(コードが表すものと)異なるタイプの情報を提供することで、良いコードを補完するものだ」との見解を示した。その理由としてシステムアーキテクトのピーター・ヴォーゲル氏が2013年に投稿したコメントに関する3つの事実を挙げた。 (1)コメントを書いて、維持するには費用がかかる (2)コンパイラはコメントを無視するため、コメントの内容が正しいかどうか機械的
![コードのコメント、何をどう書けばよいのか](https://cdn-ak-scissors.b.st-hatena.com/image/square/182bbd02e1af2d4dc670c69f7431b8e1659d0245/height=288;version=1;width=512/https%3A%2F%2Fimage.itmedia.co.jp%2Fait%2Farticles%2F2202%2F02%2Fcover_news077.png)