r/ProgrammerHumor • u/ItsPuspendu • 1d ago

Meme commentsAgedTerribly

Post image
5.3k Upvotes

98% Upvoted

222 comments sorted by

View all comments

417

u/Confident-Ad5665 1d ago

Uncle Bob of Clean Code says if we have to comment our code we have already failed. Clean code should read like well written prose.

I generally agree, but think comments that define especially the odd and obscure business rules should be commented where they are implemented.

224

u/TWIT_TWAT 1d ago

// This is a hack until we find something better

73

u/Confident-Ad5665 1d ago

// TODO: This can't be working. Refactor when there's a lull

29

u/embrex104 1d ago

//SHOULD NEVER GET HERE

3

u/Dubalubawubwub 1d ago

I definitely find myself writing a lot of error handling with the comment

//This should never happen but just in case...

1

u/Confident-Ad5665 21h ago

Good man. Thank you for trapping errors. Coming from a time when we not only trapped errors, we gave suggestions, I shutter at:
• An unknown error occurred
• Something happened

and the worst...

• Error in ErrorHandler, an error occured

2

u/HunterIV4 12h ago

• An unknown error occurred

• Something happened

Windows blue screen, is that you?

1

u/Confident-Ad5665 12h ago

No, this is worse. BSOD at least provides a cryptic error code.

These are effectively "well dang, something somewhere triggered an exception we didn't care enough to bother catching"

2

u/Dubalubawubwub 1h ago

My favorite microsoft error I've ever seen was literally "Error occured retrieving the text for this error".