ihcomega https://blog.hatena.ne.jp/ihcomega/ よこなのへたのよこずき https://ihcomega.hatenadiary.com/ 見ているプロジェクト、自分の感覚では結構ソースコードコメントがない（皆無ってわけじゃないけど体感少ない）。前職は金融系ではちゃめちゃに複雑な業務知識が多かったのもあるけど、皆で丁寧にコメントやドキュメントを書きまくる文化があった。クラスやフィールドの説明も全部あったし、メソッドにもどういう理由で何がしたいかとかwikiへのリンクとかが添えられていた記憶がある。 今は コメントを書くより命名やテストでやりたいことを示そう コミットログやGitHubで辿れる履歴を見ながらチームで話そう コメントとソースコードが乖離した場合、コメントがないよりもマズい などの理由でソースコードコメントがあまりない。… 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fihcomega.hatenadiary.com%2Fentry%2Fcode-comments" title="ソースコードコメント少なめの文化に触れている。しばらく試してみよう - よこなのへたのよこずき" class="embed-card embed-blogcard" scrolling="no" frameborder="0" style="display: block; width: 100%; height: 190px; max-width: 500px; margin: 10px 0px;"></iframe> Hatena Blog https://hatena.blog 2023-01-23 23:30:00 rich https://ihcomega.hatenadiary.com/entry/code-comments 1.0 100%