[baha_man]

Writing good code is both difficult and all about communication. If you can write good code, you're probably capable of writing good documentation (low level technical documentation in your native language, at any rate) if you really want to.

[mechanical_fish]

By "no easy task" he doesn't mean it's some kind of intractable problem. (Though it is much harder for some than others.) The problem is that it takes non-negotiable amounts of time. Writing is work.

Even if you're one of those rare people who can just sit down and type press-ready copy (cough Isaac Asimov cough) it takes time to physically type it all.

[ivanyv]

I kind of disagree. While I agree with your first statement somewhat, I know many programmers who can express themselves pretty well in their language of choice, but when it comes to human communication, well... ;-)

[tjic]

> If you can write good code, you're probably capable of writing good documentation

Indeed, but is that the best use of time for someone who can write good code?

http://en.wikipedia.org/wiki/Ricardo%27s_law