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

I'll just leave this here: http://www.martinfowler.com/bliki/CodeAsDocumentation.html 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.