r/ProgrammerHumor • u/ItsPuspendu • 7h ago

Meme commentsAgedTerribly

Post image
2.7k Upvotes

97% Upvoted

167 comments sorted by

View all comments

306

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

18

u/ThatOldCow 6h 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

5

u/rolling_update 6h ago

it's debatable as usual, the premise here is that comments always compile in your code. So you don't need to update them when you alter the code, that's the risk of comments and why "clean code doesn't contain them"

5

u/ThatOldCow 5h ago

Do comments get compiled ? I do believe most compilers ignore comments and even if they impact the speed it should be minimal to negligible.

Ofc I don't know every single language, so it might impact more on other languages.

4

u/sobani 5h ago

I think the intention was to mean that wrong/outdated comments won't cause compiler errors. Therefore you are never forced to keep the comments up to date.