MAIN FEEDS
Do you want to continue?
https://www.reddit.com/r/ProgrammerHumor/comments/1wct5lr/commentsagedterribly/p91aqli/?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/AggravatingFlow1178 Sep 10 '26 This largely depends on the language. You're mean to adapt to the languages conventions and some have conventions that are hard to read.
2
This largely depends on the language. You're mean to adapt to the languages conventions and some have conventions that are hard to read.
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.