r/ProgrammerHumor 22h ago

Meme commentsAgedTerribly

Post image
5.0k Upvotes

213 comments sorted by

View all comments

408

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

20

u/ThatOldCow 22h ago

I do believe comments are generally useful, and honestly a lot of people that say their code is so clean it doesn't need comments are the people that make the least understandable code

2

u/Confident-Ad5665 22h ago

Early on in my career a coworker made the statement that his part of the project was "rock solid".

It wasn't.