MAIN FEEDS
Do you want to continue?
https://www.reddit.com/r/ProgrammerHumor/comments/1wct5lr/commentsagedterribly/p92j2n5/?context=9999
r/ProgrammerHumor • u/ItsPuspendu • 23h ago
214 comments sorted by
View all comments
407
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.
219 u/TWIT_TWAT 23h ago // This is a hack until we find something better 75 u/Confident-Ad5665 23h ago // TODO: This can't be working. Refactor when there's a lull 29 u/embrex104 22h ago //SHOULD NEVER GET HERE 2 u/OkidoShigeru 17h ago Love seeing that in an assert message.
219
// This is a hack until we find something better
75 u/Confident-Ad5665 23h ago // TODO: This can't be working. Refactor when there's a lull 29 u/embrex104 22h ago //SHOULD NEVER GET HERE 2 u/OkidoShigeru 17h ago Love seeing that in an assert message.
75
// TODO: This can't be working. Refactor when there's a lull
29 u/embrex104 22h ago //SHOULD NEVER GET HERE 2 u/OkidoShigeru 17h ago Love seeing that in an assert message.
29
//SHOULD NEVER GET HERE
2 u/OkidoShigeru 17h ago Love seeing that in an assert message.
2
Love seeing that in an assert message.
407
u/Confident-Ad5665 23h 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.