RE: Tool for dynamic, customized documentation

Subject: RE: Tool for dynamic, customized documentation
From: "Mark Baker" <mbaker -at- ca -dot- stilo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 24 Jul 2003 11:28:02 -0400

> I'd like to create documentation based on
> the suite of
> tools that a user has purchased. For example, they can purchase anywhere
> from zero to five tools that allow them to import different types of data
> into our software.

Now here it the kind of application for which XML works very well. The
scenario you describe requires a custom build of information depending on a
set of specialized conditions. You can create an XML format for your
information that defines the relationships you have described between the
products purchased and the instructions to be followed.

> In addition, I would like them to be able to type in custom
> information such
> as their "live date" and have that populate various spots in the docs.

You should be able to accomplish this in a browser using a combination of
Java Script and XSLT.

> I have Office 2000, Framemaker 7, Robohelp 2000 and DemoShield at my
> disposal. Anyone think of a good way to accomplish this in any
> one of these
> tools (or in another, economical and easy to learn tool)?

XML, XSLT, Java Script, and browsers are all freely available. They should
suffice unless the size of the documentation set is quite large.

Mark Baker
Stilo Corporation
1900 City Park Drive, Suite 504 , Ottawa, Ontario, Canada, K1J 1A3
Phone: 613-745-4242, Fax: 613-745-5560
Email mbaker -at- ca -dot- stilo -dot- com

This message, including any attachments, is for the sole use of the
intended recipient and may contain confidential and privileged
information. Any unauthorized review, use, disclosure, copying, or
distribution is strictly prohibited. If you are not the intended
recipient please contact the sender by reply email and destroy
all copies of the original message and any attachments.


sourcing tool for FrameMaker that lets you easily publish your content
online. No macro language required!

Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See or write George Hayhoe at hayhoe_g -at- mercer -dot- edu -dot-

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 for more resources and info.

Tool for dynamic, customized documentation: From: dthomps

Previous by Author: RE: Help with Docbook (an alternative)
Next by Author: RE: Help with Docbook
Previous by Thread: Tool for dynamic, customized documentation
Next by Thread: RE: Tool for dynamic, customized documentation

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

Sponsored Ads