If your code needs comments, it's either because it's unnecessarily complex/convoluted, or because there's more thought in it (e.g. complex mathematic operations, or edge-cases etc.). Comments just often don't age well IME, and when people are "forced" to read the (hopefully readable) code, they will more likely understand what is really happening, and the relevant design decisions.

Good video I really recommend: https://www.youtube.com/watch?v=Bf7vDBBOBUA

[–] Vilian@lemmy.ca 5 points 11 months ago* (last edited 11 months ago) (7 children)

and if you need an unnecessarily complex code for performance sake?

[–] hstde@feddit.de 14 points 11 months ago (1 children)

There's a comment for you to explain the why.

Rule of thumb: code explains the how and what, comments explain the why.

[–] philm@programming.dev 3 points 11 months ago

Yeah that's a good summary

load more comments (5 replies)

load more comments (40 replies)