Re:Every line of code is always documented
by RyanZAG on Saturday February 08, 2014 @03:22PM
(#7202513)
What? No, it's got nothing to do with commenting. It's to do with basic code design: put your stuff in functions. A line like that should have been in a function to start with, and it should have been caught during a code review or as common sense by the committer before he even committed.
[ Parent
| on HN ]
Re:Every line of code is always documented
by aidos on Saturday February 08, 2014 @05:18PM
(#7203043)
Agreed. Maybe it's in some insane tight loop where you don't want a function call - in which case you comment it. My rule is that if there's something I have to put in the code that's out of the ordinary, I comment to explain.
Re:Every line of code is always documented
by etler on Saturday February 08, 2014 @05:14PM
(#7203010)
The point of the article has nothing to do with the code snippet. My point has nothing to do with the code snippet. It's just about code in general, and it's never as easy to understand as you want it to be.
Re:Every line of code is always documented
by stcredzero on Sunday February 09, 2014 @07:02AM
(#7205253)
basic code design: put your stuff in function
Aye, and with intention revealing names!