News for hackers. Stuff that matters.

A comment on It’s Time We Stopped Rewarding Projects with Crappy Documentation. Parent comment

Re:It’s Time We Stopped Rewarding Projects with Crappy Docum... by baha_man on Wednesday August 05, 2009 @12:14PM (#743663)
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.
[ Parent | on HN ]
Re:It’s Time We Stopped Rewarding Projects with Crappy Docum... by mechanical_fish on Wednesday August 05, 2009 @12:54PM (#743746)
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.

[ Parent | on HN ]
Re:It’s Time We Stopped Rewarding Projects with Crappy Docum... by ivanyv on Wednesday August 05, 2009 @12:18PM (#743668)
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... ;-)
[ Parent | on HN ]
Re:It’s Time We Stopped Rewarding Projects with Crappy Docum... by tjic on Wednesday August 05, 2009 @01:34PM (#743840)
> 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

[ Parent | on HN ]