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 11:59:27 -0800

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?"
>
> http://www.technewsworld.com/story/68798.html?wlc=1259948629
>
> 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:
http://www.doctohelp.com/

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. http://www.helpandmanual.com/

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


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
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Follow-Ups:

References:
Bad Documentation and Linux: From: Dana Worley

Previous by Author: Re: I'm now blogging about Agile & TW
Next by Author: Re: Bad Documentation and Linux
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