I totally agree with you and your article :) I'm working with this approach all the time!

Thank you! The article is great, but maybe a bit long. I'm afraid, if I recommend it to my colleagues, they won't read it :(

Could it be abbreviated, or split into a series?

Same spot, 2006 :)

I like code too much, but I know talking to people is more important. I know I write more valuable code, if I talk more to people. Hard daily compromise :)

Yup! Documentation should only be created as a last resort. Otherwise it's often a waste, or worse - misleading.