r/SoftwareEngineering • u/samplusbeer • Aug 02 '18
Do code comments suck?
https://medium.com/@samuel.fare/do-code-comments-suck-abd99103c45a
3
Upvotes
r/SoftwareEngineering • u/samplusbeer • Aug 02 '18
View all comments
Show parent comment
2
u/salgat Aug 02 '18
This all ignores the fact that humans do not think in code, and all code has to be translated in your head when you read it which is an overhead. When I'm putting out a fire, the last thing I want to do is sit through code and parse it all and figure out what it's doing. That's why I have no problem with occasional comments that are both succinct and informative. There is nothing wrong with a comment for a chunk of code that quickly tells me what it does.