[EMAIL PROTECTED] 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
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]