Best comment ever was "It used to work like this but person at client demanded it work like that on this date" when the client complained it shouldn't work like that.

[–] conciselyverbose@sh.itjust.works 1 points 2 years ago (1 children)

That's basically what comments are most useful for. When you're doing something that's not obvious, and want to make sure the "why" doesn't get lost to time.

[–] kubica@fedia.io 1 points 2 years ago (2 children)

// I'm not really that dumb, there is a reason.

[–] DarkDarkHouse@lemmy.sdf.org 1 points 2 years ago

// narrator: the reason was management

[–] NotMyOldRedditName@lemmy.world 1 points 2 years ago* (last edited 2 years ago)

// I told them I'd do this but only if they gave me time next sprint to fix it  - 12-03-1997

[–] 0x0@lemmy.dbzer0.com 1 points 2 years ago

The best comments are "why" comments, the runner up is "how" comments if high-level enough, and maybe just don't write "what" comments at all because everyone reading your code knows how to read code.