News for hackers. Stuff that matters.
Re:Useful GitHub patterns by diggan on Wednesday July 10, 2013 @08:31PM (#6023758)
A good thing to think when you start adding documentation to the code is "Am I really writing readable and understandable code right now?". If you answer isn't yes without any hesitation, you usually need to refactor so other people can read your code instead of you needing to comment what you do.
Re:Useful GitHub patterns by thelastnode on Wednesday July 10, 2013 @08:57PM (#6023870)
True, but sometimes there isn't a choice, e.g., working with a clowntown library, poorly designed legacy code, etc.