プログラムにコメント書かない文化もあるよって話
という話があるらしい。
自分は逆の考え方だ。
「コードを読まなくてもコメントだけ読めば概略が分かるように」を心がけてる。ちょうど、見出しだけ読めば何が書かれているか分かるのがいい文章であるように。
コメントの有用性を理解したければ、Rubyのgem、active_supportのソースを読むといい。このソースにはコメントが豊富だが、コメントなしで理解できるか?壊さずに変更を加える自信はあるか?
More than 5 years have passed since last update.
プログラムにコメント書かない文化もあるよって話
という話があるらしい。
自分は逆の考え方だ。
「コードを読まなくてもコメントだけ読めば概略が分かるように」を心がけてる。ちょうど、見出しだけ読めば何が書かれているか分かるのがいい文章であるように。
コメントの有用性を理解したければ、Rubyのgem、active_supportのソースを読むといい。このソースにはコメントが豊富だが、コメントなしで理解できるか?壊さずに変更を加える自信はあるか?
Register as a new user and use Qiita more conveniently