News for hackers. Stuff that matters.
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.
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.