コードを直訳したコメントは必要なのか?「要る派」と「要らない派のまとめ」【 社畜ちゃん台詞メーカー 】
コードを直訳したコメントは必要なのか?
というお題を
社畜ちゃん台詞メーカーで画像を作って投下してみたところ、たくさんのご意見をいただいたのでまとめてみました。
らくつみ
@rakutsumi
書かなくていいと言うと、そのうちめんどくさがって書いといたほうがいいのも書かない気がするから書くようにしてほしいね。 あと、全部に日本語でコメント入ってると、日本語で検索かけられて楽。
2015-06-30 19:15:03
和
@kazu000001
@vitaone_ 組む人のレベルにもよりますね。 少なくともコメントとソースがずれているのは絶対に止めてほしいですね。担当外したいくらい。 新手の難読化かと…(ぉぃ
2015-06-30 19:16:06
✨ マーク卿 JP ✨
@andramarc
@vitaone_ 日本語cobolがない時代の名残だよ コメントがないとソース読めなかったんだよ 今の時代必要と思わないけどね
2015-06-30 19:16:23
ますださん
@sept_aberi
@Waaaataro @vitaone_ わたし「コードの意味を分かりやすくするのがコメントの役割だ!」 相手「この程度のコードが理解できないヤツぁ辞めちまえ!」 わたし「」
2015-06-30 19:17:51
タナカ
@tanaka_gabber
なんだかんだで日本語の方が一瞬で理解しやすいからあるに越したことはないかと(LaTeXでコメントさぼってしょっちゅう行方不明になる顔)
2015-06-30 19:18:01
hyu
@hyutec
書く意味ある派です。世の中には1ステップ1コメントなんていうオーダーもある位。流石にそこまで行くとやり過ぎかなと思う面はありますが。コメントが少ないソースの難読性で苦労した経験のある自分としては、無くて困る事はあっても、有って困るコメントは無い。と思うです。
2015-06-30 19:25:22
結城浩 / Hiroshi Yuki
@hyuki
本を書く生活が30年を過ぎ、著書は60冊を越えました。『数学ガール』の作者です。結城メルマガとWeb連載を毎週書いてます。文章書きとプログラミングが好きなクリスチャン。気軽に絡んでくださいね。いつも応援感謝です。
結城浩 / Hiroshi Yuki
@hyuki
それはそれとして、コード直訳したようなコメントは、文法解説書やサンプルコードでなければいらないと思います。コメントはコードから読み取りにくいことを書く方がいいでしょうね。
2015-06-30 19:25:51