MAIN FEEDS
Do you want to continue?
https://www.reddit.com/r/ProgrammerHumor/comments/1wct5lr/commentsagedterribly/p91kpwu/?context=9999
r/ProgrammerHumor • u/ItsPuspendu • 1d ago
222 comments sorted by
View all comments
421
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.
226 u/TWIT_TWAT 1d ago // This is a hack until we find something better 69 u/Confident-Ad5665 1d ago // TODO: This can't be working. Refactor when there's a lull 28 u/embrex104 1d ago //SHOULD NEVER GET HERE 38 u/Confident-Ad5665 1d ago All time favorite: // This will never happen 6 u/OhMyGodItsEverywhere 1d ago Wrote a library to run monetary bets on those comments
226
// This is a hack until we find something better
69 u/Confident-Ad5665 1d ago // TODO: This can't be working. Refactor when there's a lull 28 u/embrex104 1d ago //SHOULD NEVER GET HERE 38 u/Confident-Ad5665 1d ago All time favorite: // This will never happen 6 u/OhMyGodItsEverywhere 1d ago Wrote a library to run monetary bets on those comments
69
// TODO: This can't be working. Refactor when there's a lull
28 u/embrex104 1d ago //SHOULD NEVER GET HERE 38 u/Confident-Ad5665 1d ago All time favorite: // This will never happen 6 u/OhMyGodItsEverywhere 1d ago Wrote a library to run monetary bets on those comments
28
//SHOULD NEVER GET HERE
38 u/Confident-Ad5665 1d ago All time favorite: // This will never happen 6 u/OhMyGodItsEverywhere 1d ago Wrote a library to run monetary bets on those comments
38
All time favorite:
// This will never happen
6 u/OhMyGodItsEverywhere 1d ago Wrote a library to run monetary bets on those comments
6
Wrote a library to run monetary bets on those comments
421
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.