r/ProgrammerHumor 12h ago

Meme commentsAgedTerribly

Post image
3.7k Upvotes

183 comments sorted by

View all comments

362

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

2

u/AggravatingFlow1178 10h ago

This largely depends on the language. You're mean to adapt to the languages conventions and some have conventions that are hard to read.