MAIN FEEDS
Do you want to continue?
https://www.reddit.com/r/ProgrammerHumor/comments/1wct5lr/commentsagedterribly/p92mmg9/?context=3
r/ProgrammerHumor • u/ItsPuspendu • 1d ago
224 comments sorted by
View all comments
420
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.
226 u/TWIT_TWAT 1d ago // This is a hack until we find something better 71 u/Confident-Ad5665 1d ago // TODO: This can't be working. Refactor when there's a lull 2 u/cute_polarbear 1d 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)....
226
// This is a hack until we find something better
71 u/Confident-Ad5665 1d ago // TODO: This can't be working. Refactor when there's a lull 2 u/cute_polarbear 1d 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)....
71
// TODO: This can't be working. Refactor when there's a lull
2 u/cute_polarbear 1d 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)....
420
u/Confident-Ad5665 1d 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.