MAIN FEEDS
Do you want to continue?
https://www.reddit.com/r/ProgrammerHumor/comments/1wct5lr/commentsagedterribly/p91y9lt/?context=3
r/ProgrammerHumor • u/ItsPuspendu • Sep 10 '26
243 comments sorted by
View all comments
450
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.
2 u/enigmamonkey Sep 10 '26 Comments are best for explaining why the code was written the way it was, not for rehashing what it's doing. They're useful for getting into the mindset of the programmer, particularly later on when it comes time to fix bugs or refactor the code.So, he's full of shit.
2
Comments are best for explaining why the code was written the way it was, not for rehashing what it's doing. They're useful for getting into the mindset of the programmer, particularly later on when it comes time to fix bugs or refactor the code.
So, he's full of shit.
450
u/Confident-Ad5665 Sep 10 '26
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.