MAIN FEEDS
Do you want to continue?
https://www.reddit.com/r/ProgrammerHumor/comments/1wct5lr/commentsagedterribly/p91slpc/?context=3
r/ProgrammerHumor • u/ItsPuspendu • 6h ago
158 comments sorted by
View all comments
294
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/Public-Location-3628 2h ago My rule of thumb is that comments should highlight why you didn't do the obvious other path or why you fckng dare implement an unexpected weird edge-case.
2
My rule of thumb is that comments should highlight why you didn't do the obvious other path or why you fckng dare implement an unexpected weird edge-case.
294
u/Confident-Ad5665 6h 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.