[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: what's up with all the attitude



hendrik@topoi.pooq.com wrote:

There's something that's always bothered me -- how many developers write usable documentation? And how many technical writers are capable of digging through code and descussions on -devel mailing lists to extract the information that needs to be written? I suspect the answer is "few". If so, how cen we ever hope to get the documentation both up-to-date and useful?

Unless your goal is not to "scratch your own itch" to create software -- you'll never get good documentation out of the developer. It's not what they're motivated to do, and they get no benefit from writing docs for themselves on things they already know about their own software.

Basic economics at play here. If someone had a selfish reason to write better docs and share them, they would.

Nate



Reply to: