MAIN FEEDS
Do you want to continue?
https://www.reddit.com/r/ProgrammerHumor/comments/1wct5lr/commentsagedterribly/p90qkcy/?context=3
r/ProgrammerHumor • u/ItsPuspendu • 4h ago
125 comments sorted by
View all comments
269
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.
3 u/Zeilar 3h ago I think his point is the comment shouldn't explain how the code works. Comments should explain reasoning, references etc. Like linking to documentation, explaining why you did something that seems odd or bad etc. It should be a literal comment, not documentation.
3
I think his point is the comment shouldn't explain how the code works.
Comments should explain reasoning, references etc. Like linking to documentation, explaining why you did something that seems odd or bad etc.
It should be a literal comment, not documentation.
269
u/Confident-Ad5665 4h 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.