Bad Documentation and Linux

Subject: Bad Documentation and Linux
From: "Dana Worley" <dana -at- campbellsci -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Fri, 04 Dec 2009 11:01:49 -0700

Some interesting comments about Linux documentation (or lack thereof). "Is Bad
Documentation Derailing Linux?"

I'm amused by the "they don't even read it" comments. The person says she was paid to
create GOOD documentation (her caps, not mine) -- 123 pages in two days. I bet my idea of
GOOD and her idea of GOOD are vastly different. I'd probably not read the document either
after the first few pages ;)

It does point out there is a need in the open source community for technical writers. Not that
it will pay the mortgage, but think of the glory ;)

Just a little Friday fodder for conversation.

Dana W.

Dana Worley
Software Product Manager/Manager, Software Support Group
Campbell Scientific, Inc.
Microsoft MVP, Windows Help


Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:

Help & Manual 5: The all-in-one help authoring tool. True single- sourcing --
generate 8 different formats and as many different versions as you need
from just one project. Fast and intuitive.

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:


Previous by Author: RE: Bad Salary Omens
Next by Author: RE: Bad Documentation and Linux
Previous by Thread: RE: charging for contract work
Next by Thread: Re: Bad Documentation and Linux

What this post helpful? Share it with friends and colleagues:

Sponsored Ads