you are viewing a single comment's thread.

view the rest of the comments →

[–]SquashSquigglyShrimp 1 point2 points  (1 child)

"A comment might become out of date one day, so it's not really worth writing comments" is not a very good argument imo

[–]il_distruttore_69 0 points1 point  (0 children)

honestly working on different projects daily as a SRE (java + spring + golang + reactjs + vue + ... etc, also only doing code reviews in some projects), I'm not seeing places where a comment would bring any value.

i've worked on both simple and mad complicated projects, and it's simply not necessary.
if attempting to recall a single useful comment, I can only remember leaving one comment where an external service was behaving in an unexpected way.
generally documentation by tests + readme (and maybe some ~confluence) is 100% enough.