3 ms·
I don't think there's a need to "deal with" them. Writing self-describing code is better than writing code that requires comments to be understood. Writing obvi
by ville 14y ago
I don't think there's a need to "deal with" them. Writing self-describing code is better than writing code that requires comments to be understood. Writing obvious comments that tell what could be read from the code is bad because now you need to maintain the comment as well or it becomes outdated making it much worse than no comments at all.
You should focus on the code not being self-documenting enough, not the lack of comments.
Here are some excuses people use to justify comments:
http://www.codeodor.com/index.cfm/2008/6/18/Common-Excuses-Used-To-Comment-Code-and-What-To-Do-About-Them/2293 http://www.codeodor.com/index.cfm/2008/6/18/Common-Excuses-U...