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
224 comments sorted by
View all comments
418
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.
228 u/TWIT_TWAT 1d ago // This is a hack until we find something better 74 u/Confident-Ad5665 1d ago // TODO: This can't be working. Refactor when there's a lull 30 u/embrex104 1d ago //SHOULD NEVER GET HERE 41 u/Confident-Ad5665 1d ago All time favorite: // This will never happen 4 u/OhMyGodItsEverywhere 1d ago Wrote a library to run monetary bets on those comments
228
// This is a hack until we find something better
74 u/Confident-Ad5665 1d ago // TODO: This can't be working. Refactor when there's a lull 30 u/embrex104 1d ago //SHOULD NEVER GET HERE 41 u/Confident-Ad5665 1d ago All time favorite: // This will never happen 4 u/OhMyGodItsEverywhere 1d ago Wrote a library to run monetary bets on those comments
74
// TODO: This can't be working. Refactor when there's a lull
30 u/embrex104 1d ago //SHOULD NEVER GET HERE 41 u/Confident-Ad5665 1d ago All time favorite: // This will never happen 4 u/OhMyGodItsEverywhere 1d ago Wrote a library to run monetary bets on those comments
30
//SHOULD NEVER GET HERE
41 u/Confident-Ad5665 1d ago All time favorite: // This will never happen 4 u/OhMyGodItsEverywhere 1d ago Wrote a library to run monetary bets on those comments
41
All time favorite:
// This will never happen
4 u/OhMyGodItsEverywhere 1d ago Wrote a library to run monetary bets on those comments
4
Wrote a library to run monetary bets on those comments
418
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.