RE: Linux documentation tools

["Jim Shaeffer" <jims -at- spsi -dot- com>]

If Sean Wheller's statements are true: 

> The Editor and Tool Chain is not really a problem. The
> BIGGEST PROBLEM is changing the mindset of the Author
> or contributors. To do this you will have to show very
> real business and user benefit. Then you will have to
> train the authors/contributors.
> 
> Fortunately Docbook is well documented, so training
> materials abound.

Then most of us will abandon all further research into  
and consideration of these tools. The difficulties 
inherent in retraining authors/contributors are the 
very difficulties we were hoping to resolve by using 
new tools that would enforce and impose structure. 

Changing the tools is easy. Changing human behavior is  
hard. (It is theoretically possible to train people to 
use MS WORD to create well-structured documents that 
can easily be used as parts of a single-source 
repository.)

Jim Shaeffer (jims -at- spsi -dot- com)


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

NEED TO PUBLISH YOUR FRAMEMAKER CONTENT ONLINE?

RoboHelp for FrameMaker is a NEW online publishing tool for FrameMaker that
lets you easily single-source content to online Help, intranet, and Web.
The interface is designed for FrameMaker users, so there is little or no
learning curve and no macro language required! Call 800-718-4407 for
competitive pricing or view a live demo at: http://www.ehelp.com/techwr-l3

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot-  Visit
http://www.raycomm.com/techwhirl/ for more resources and info.