昔はよく、何でもかんでも、コメントを残せみたいに言われてた時期もあったような、なかったような気がするわけだが、

最近ではむしろ、とことんコードにはコメントを残さず、コードにコメントが残ってたらレビュワーが、「コメントはコミットに残すな」というような現場も多い。

なぜ、そういう感じになったのかを、少し推察してみたいのだが、要は、

一般的に、コードのコメントは、普通に読んでて読者が分かりにくいと思う部分だったりを、「これこれこういう理由がありまして、今はこういう風な実装になっています」という感じで使うものだという認識が広まったからではないかと思う。

コードの処理だったり、内容そのものは、コード読んで読解してほしいと考えているため、なるべくコメントみたいな形で、余分な文字を増やしたくないみたいな。

いいコメントは「なぜ、その実装に至ったか読者に説明する」悪いコメントは、コードがやっている処理を説明する、ということで、そもそもコメントを残すこと自体、アブノーマルなことが起こってることを示唆するものと認識されてるからじゃないかなと思ったりラジバンダリー。

個人的に私は、読者が分かりやすく読めるために、何をすべきか？たくさん考えると、たくさんコメントを書きたくなってしまうタチです。

題名、「こんなコードコメントは嫌だ」NFTにして売り出します。wwwwwwww #プログラミング #プログラミング初心者と繋がりたい #プログラミング独学 #プログラミング勉強中 #プログラミングスクール #駆け出しエンジニアと繋がりたい #フリーランスエンジニア #エンジニア転職 #フロントエンド #ブログ pic.twitter.com/Z7gpHUB29n

— りょすけ (@ryosuke_hu) November 2, 2021