Re:Reading Other People's Code (2012)
by ptzolov on Wednesday September 04, 2013 @02:19PM
(#6329352)
I think reading code is a very good practice, and the more you read the easier "step 2" (the understanding bit anyways) becomes. That being said, I don't think reading through huge blocks of comments so that you can understand a function is useful. Forcing yourself to write self-explanatory code with a short docstring is a lot more useful than some hacky code with a huge comment explaining what it does.
[ Parent
| on HN ]
Re:Reading Other People's Code (2012)
by DigitalJack on Wednesday September 04, 2013 @02:32PM
(#6329466)
I very much agree with this. Succinct comments have the advantage of being easier to keep in sync with code changes.