Re:The Most Important Code Isn't Code
by sofuture on Tuesday June 07, 2011 @08:42PM
(#2631578)
I absolutely agree. I don't comment all that much, but comment where it's impossible to get clarity -- or comment at a higher level to explain the rationale for the code.
Commenting what code does -- is either 1) pointless or 2) indicative you should rewrite your explanation-requiring code in a more straightforward fashion.
Re:The Most Important Code Isn't Code
by gaius on Wednesday June 08, 2011 @07:52AM
(#2632747)
I comment for one person and one person only: myself in 6 months or 2 years when I've forgotten everything about this code! Strangely enough, that kind of attitude results in comments that everyone finds useful.
Commenting what code does -- is either 1) pointless or 2) indicative you should rewrite your explanation-requiring code in a more straightforward fashion.