Re: Bad Documentation and Linux

[<neilson -at- windstream -dot- net>]

> result never got read.
> 
> "Why? 'Oh, it's too big,'" she recounted.

I was told my doc was no good because there were too many steps. Well, there *were* 16 steps! The product required the user to do every one of them. And indeed, I actually had overlooked an important in-between step. There were really 17.

The product was later revised to work with just one step.

For Linux (or any Unix) if you want to do command-line stuff, you have to wade through hairy documentation that tells you about hairy options you'd rather ignore. Personally, I like Unix command lines and am willing to read man pages. There *are* "Linux for the Terminally Drain Bamaged" books out there, I'm sure. Probably nobody reads them, too.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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