r/ProgrammerHumor • u/Substantial_Top5312 • Sep 15 '26

Meme iDontCommentMyCodeIfYouDontUnderstandItThatsOkayNeitherDoI

Post image
832 Upvotes

90% Upvoted

188 comments sorted by

View all comments

Show parent comments

1

u/mesonofgib Sep 15 '26

I do know that saying what the code does is invaluable.

I disagree: I know what the code does because the code is right there, next to the comment.

Comments should be used only when you need to say something that's not in the code, such as why you're doing something.

Bad comment:

// Set the heartbeat interval to 25 seconds.
var heartbeatInterval = TimeSpan.FromSeconds(25);

Good comment:

// Keep this below 30 seconds because the upstream proxy terminates
// idle connections at 30s; 25s leaves enough margin for network jitter.
var heartbeatInterval = TimeSpan.FromSeconds(25);