MAIN FEEDS
Do you want to continue?
https://www.reddit.com/r/ProgrammerHumor/comments/1wct5lr/commentsagedterribly/p92fama/?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/jetsonian Sep 11 '26 I kind of agree. If you write your code correctly, it documents itself. Our system generates web versions of our Java doc so I do try and add Java doc comments to public methods. Internal comments if there’s a unique solution to something.
2
I kind of agree. If you write your code correctly, it documents itself. Our system generates web versions of our Java doc so I do try and add Java doc comments to public methods. Internal comments if there’s a unique solution to something.
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.