Document the Why

Re:Document the Why by mercurial on Thursday March 07, 2013 @06:07AM (#5337084)

Actually, that's what we use with a rather large codebase, and it works out pretty well. Different tacks for different people, I suppose.

[ Parent | on HN ]

Re:Document the Why by timr on Thursday March 07, 2013 @08:49PM (#5341676)

Not really, no. It's not a matter of opinion.

You can obviously get away with not documenting code, but you don't know what it's costing you. However well things are working out now, I can guarantee that they'd be working better and faster for your team if you spent the time to write good documentation.

[ Parent | on HN ]

Re:Document the Why by mercurial on Friday March 08, 2013 @03:04AM (#5342465)

I'll just leave this here: http://www.martinfowler.com/bliki/CodeAsDocumentation.html

You may think Martin Fowler is one of these "experienced people who suck at what they do", but you're likely to find yourself part of a small minority.

[ Parent | on HN ]