Re: Bad Documentation and Linux

Subject: Re: Bad Documentation and Linux
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Fri, 4 Dec 2009 12:02:10 -0800

Also, there doesn't seem to be a Slashdot blogger named Barbara Hudson.

On Fri, Dec 4, 2009 at 11:59 AM, Robert Lauriston <robert -at- lauriston -dot- com> wrote:
> She didn't say the stuff she whipped out in two days was good, to the contrary:
> "The only time I've been paid to do GOOD documentation was when it was
> going to be used to wow investors during the dot-com boom," Slashdot
> blogger Barbara Hudson told LinuxInsider. "Bosses nowadays don't seem
> to get that good documentation saves money."
> Even worse, "when you document something, they don't even read it,
> even though they should," Hudson added.
> Case in point: "Last year I spent two days doing 'Complete
> Documentation -- everything -- and it needs to be ready by Thursday'
> of the system we were working on," she explained. "123 pages worth,
> table of contents, footnotes, index, overview, the whole bit."
> It was a week's worth of work done in two days, Hudson noted, but the
> result never got read.
> "Why? 'Oh, it's too big,'" she recounted.
> On Fri, Dec 4, 2009 at 10:01 AM, Dana Worley <dana -at- campbellsci -dot- com> wrote:
>> 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 ;)

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:


Bad Documentation and Linux: From: Dana Worley
Re: Bad Documentation and Linux: From: Robert Lauriston

Previous by Author: Re: Bad Documentation and Linux
Next by Author: Re: word of the day
Previous by Thread: Re: Bad Documentation and Linux
Next by Thread: Re: Bad Documentation and Linux

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

Sponsored Ads