コメントについて考えてみた - 日々常々

やきに駆動2.0で話した内容です。 資料 コメントについて考えてみた 長いよ？ コメント書いてますか？ コードにコメントを書くことは、犬の散歩で糞を持ち帰ることくらい常識的なマナーです。皆さんコードにコメントは書いていらっしゃるでしょうか？ 書いてます？書いてます。はい。そうですよね。……なんで？ コメントを書く理由を考えたことはあるでしょうか。コメントを書くと、コストがかかります。コメントを書く程度のコストは無視できるものかもしれませんが、書いたコメントを残すと、残っている限りずっとコストをかけ続けることになります。なので、コメントにはリターンが求められて然るべきです。理由のないコメントは、未来の混乱を招く優れた方法です。 コメントを書く動機 コメントを書きたいと思う動機は様々あります。コードがわかり辛いところに説明を書いておく。実装の仕方がわからなくてコメントで書いて次に進んでおく。な

[naopi_chan]

新人の時に「仕様書に書いてあることをコメントに書くんだよ」って教えられた。死にたい

[pmint]

悪例しか示さない記事はありふれている。コード内のシンボル名はコメント。そのコード内コメントvsコメント構文を論じても無意味。両者を戦わせるのでなく何をどこにどう書くかじゃないと。スライドと記事でDRY違反。

[o_masaaki]

Now browsing：コメントについて考えてみた - 日々常々

[masaru_b_cl]

ウンコメントカタログが素敵

[genzouw]

履歴コメントの習慣はﾎﾝﾄﾆ根付いよ / [プログラミング][slide]コメントについて考えてみた

[sue445]

ウンコメントｗ

[a-know]

良！

[trashtoy]

だいたい同意。このエントリと一緒にリーダブルコードも読みましょう。

[raimon49]

クソコメント例文集　履歴コメントは即刻削除すべしはその通りだし、新人やかつて新人だったあの時の自分に真っ先に読んで欲しいドキュメント

[kumaroku]

スライドとブログの両方をみるとものすごく解りやすいです。まとめ方もいいなぁ。すばらしい！

[rryu]

「コメントは消臭剤である」というのは良いたとえかも。本来なら要らないし無い方がいいけど、必要になる時もある。