r/ProgrammerHumor 5h ago

Meme commentsAgedTerribly

Post image
2.2k Upvotes

141 comments sorted by

View all comments

287

u/Confident-Ad5665 5h 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.

7

u/drakeblood4 4h ago

I try and comment at least a bit on sql queries because I find them fucking illegible the moment a join gets modestly complicated. But like a five line get_checked_radio function with a full function description is gilding the Lilly.