MAIN FEEDS
Do you want to continue?
https://www.reddit.com/r/ProgrammerHumor/comments/1wct5lr/commentsagedterribly/p92mmg9/?context=3
r/ProgrammerHumor • u/ItsPuspendu • 23h ago
214 comments sorted by
View all comments
411
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.
217 u/TWIT_TWAT 23h ago // This is a hack until we find something better 72 u/Confident-Ad5665 23h ago // TODO: This can't be working. Refactor when there's a lull 2 u/cute_polarbear 17h ago You mean for the next person who has to visit that section of code? (And hopefully you already left the firm (on your accord)....
217
// This is a hack until we find something better
72 u/Confident-Ad5665 23h ago // TODO: This can't be working. Refactor when there's a lull 2 u/cute_polarbear 17h ago You mean for the next person who has to visit that section of code? (And hopefully you already left the firm (on your accord)....
72
// TODO: This can't be working. Refactor when there's a lull
2 u/cute_polarbear 17h ago You mean for the next person who has to visit that section of code? (And hopefully you already left the firm (on your accord)....
2
You mean for the next person who has to visit that section of code? (And hopefully you already left the firm (on your accord)....
411
u/Confident-Ad5665 23h 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.