「コメントは書くな」 - Qiita

同僚だったロシア人のMはとにかくすごいエンジニアで、給料について社長ともめていたかと思えば、スーパーデプロイシステムを一人で作り上げていたり、Python推しの会社の中で、各所を説き伏せてTypeScript on node.jsの導入を進めたりしていた。 皮肉屋で、だれかれかまわず議論をふっかけていたが、とにかく仕事が速くて品質がよいので絶大に信頼されていた。 私は開発者としてMから様々な教えを授けられた。当時私はPHPerあがりのひよっこで、日々ダメコードを生産していた。 ある日Mにコードレビューを依頼すると、こんなことを言われた。 「堀さん！ソースコードにコメントを書いてはいけない！」 // connect to the database named "mysql" on the localhost val driver = "com.mysql.jdbc.Driver" val u

[stk132]

そりゃあ記事中のサンプルのようなコメントは不要だろうよ。処理内容じゃなくて、何故その処理を行うかという、whyのコメントは欲しい

[midnight-railgun]

適切なコメント > コメントなし >>> (超えられない壁) >>> メンテされず放置された結果「ウソ」が書いてあるコメント

[jacoby]

Howはコードで書く。Whyは自然言語で書く。/Howはドキュメントに書かずにコードに書け（コードとドキュメントの同期面倒だから）

[develtaro]

イメージどいひー。createStatement関数のコメントが// create the statement。残念ながらコメントがないとレビューで怒られる現場もあるんだ。皆が同じように整ったコードを読めるわけではないからだと。ははっ

[odakaho]

このレベルのコーダー相手なら、俺も「コメント書くな」しか言えんな。説明の手間も惜しい。 “make the connection” “create the statement” “get data from user table” “print host and user”

[gm91]

言いたいことはわかる。しかし、コメントはコードの美しさでは表現できない情報を書くものではなかろうか。

[mayumayu_nimolove]

書かないことで支障をきたすなら書けばいいのだ。エンジニアはあることの判断に、誰々がやってるからとかこう言ってるからというのはあてにしないほうがいい。

[dowhile]

ロシア人スーパープログラマー転職したら会社傾きそう

[tettekete37564]

それは超のつく理想論。読めば分かるからとコミットメッセージに何も書かないヤツと同レベル。何をやっているかはコードから分かっても「何で」「どういう目的」が分からんと保守不能。

[kazuya53]

コメント無くてもわかるコードを書けは真理だと思う

[kibitaki]

コード原理主義者はPjの「庭先」では仕事していただくが、コアコアは触らせられない。"Why"を自分の口で説明・説得できないとか、書いてあるように環境のせいにして去ることを厭わないとか、伝染力とか、諸々

[kzm1760]

書捨てツールにはコメントを書くようにしてる。（処理が雑な場合が多いので😏）

[jsstudy]

"止むに止まれぬ理由で汚いコードを書いてしまった時に、意図を伝える最後の手段がコメントである" → Gherkin https://cucumber.io/docs/gherkin/

[mieki256]

記事についたコメントを眺めていて、ソースコード内にコメントを書くべきか書かないべきかをtrue/falseで返す判別用の関数が書けそうだなと思った…条件分岐が実は多いのだな…

[d14a]

適切なコメント書くほうがコメントなしのメンテナンス性を意識したコード書くより難しいと感じることが多い件

[at_yasu]

「コメントには「なぜこのコードがあるのか」の理由を書け」ってのを意識してる。

[oktnzm]

優秀すぎると保守メンテとかにはまず入らないから信頼してよいかは微妙ですぜ／漢字は表意文字なので頭に入ってきやすい

[kkobayashi]

気持ちは分かるけど引数と返り値の説明くらいはあってもいいんじゃないかな。サンプルみたいな「コメントのためのコメント」みたいなのはクソだと思うけど

[princo_matsuri]

コメント書かないほうだけど、指差し安全確認のようなものだと思って要所で書いてる

[dexia2]

// hack for IE

[anus3710223]

書くなと言われたら書きたくなる。それがはてブ民。

[kazkun]

なんか懐かしいな。同じようなことを太古に主張してた気がする。でもドキュメントは大事だよ。

[frkw2004]

コードを読まなくて済むようにコメントする。論文とかでも章ごとのまとめだけ読めば全体の意味はわかる。

[tsu_nyan]

そのコードを扱うのが英語とコーディングの出来る人だけであればそれで良いと思うけど、日本のIT土方が絡むのであれば間違っている

[y_hirano]

筆者は綺麗なコードのためにビジネスを曲げろって言ってんだよ。言わせんなよ恥ずかしい。実際、意味不明な仕様を実装するよりもビジネスを曲げてやりたくなることは少なくないんですけどね。

[reachout]

コードを読んで挙動を理解できるレベルのエンジニアばかりだと思うんじゃあない

[trashtoy]

他の人が既に言及している通り, 初心者は「"what" ではなく "why" を記載する」というポリシーでコメントを記述するのが一番わかりやすい

[sakuragaoka]

人の書いたコード見ると命名の英語が破綻してること多いんだよね。プログラマは基礎的な英語力は必須。

[yojik]

いつもの

[koroharo]

同意 “止むに止まれぬ理由で汚いコードを書いてしまった時に、意図を伝える最後の手段がコメントである”/何をもって汚いとするかが難しい。

[dot]

コメントはコードでは表現できない必要な情報を記載すべきだし、そいうニーズは少なからずある。

[s99e209]

システム開発の分野にも色々あるだろうけど、コメントなしで読めるコードは理想ではある。もし解読不能な秘伝のコードがあっても、今ならGit logなどを辿れば実装意図が分かる仕組みがあるので便利になったなと。

[nil0303]

たまーにあるコメントなしの謎な処理は、単にアホってだけで直して良いのか意図的な何かがあるのかを確認しないといけなくなる。一律コメント無くしたら地獄。

[fukken]

サンプルコードのコメントなら、許容範囲ではあるが書くべきではないな。ちょうど英語になってることだし、関数にでも切り出して関数名とするのが妥当か。

[Lat]

私はコメントは書く。ただしドキュメントは極力書かない。じゃあドキュメントは誰が書くのか？それはA HotDocumentというツールに任せている。／これを書くのは何度目だろうか。

[deamu]

極端な理想論の宗教を崇めるのは自由だけど、その原理主義をこうやって広めて回りだすと地獄みたいな。 【コメント無い&Docs無い&作った人もう居ない】 の3重苦の引継ぎで苦しむ現場は現実にまだたくさんあるでしょ…？

[rin51]

「リーダブルコード」の翻訳レビューしたので名前載ってます

[quabbin]

直訳コメントは不要。一般に思われている以上に、コメントにはコードの構造がそうなった原因を愚痴的に書くが役に立つ(whyになっているので)。

[natu3kan]

会社や業界の文化によるよな、外注してても同じ理念を共有してる会社と提携してるならいいけど、そうじゃなきゃコメントなかったら、意図がわからず質問の嵐になりそう。

[htnmiki]

ブコメはどんどん書いていこうな。理解されなくたっていいんだ。