TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
While we don't have immediate plans here to output to HTML documentation
yet, I've recently worked out how we could. Currently, we use RoboHELP to
deliver online Help. We're planning to also single source a user's manual.
My proposal (I've just posted about this under the subject "Word 97 Linking
'Features'") is to use the special linking features in Word 97 to create
OLE links from the Word documents used in creating the Help. Both RoboHELP
and RoboHTML can output from the online Help source docs to create HTML
We archive our documentation each time we make a change. We only archive
the Word docs currently, but are looking at other options to archive all of
our working files.
On a side note, out of a purely personal interest, what tools you're using
What do you think of them?
Hope Cascio, Knowledge Transfer Developer
Diane Burke <Diane -dot- Burke -at- COGNOS -dot- COM> wrote:
I am running into a challenge with our documentation concerning archiving
single-sourcing. Indeed, are these two processes even synonymous?
Up until recently, our documentation was archived/single-sourced in MS
From this, we were able to create two outputs, WinHelp and printed
documentation, with minimal fuss. We have now added another output to the
Is anyone else putting a process into place that allows authoring and
maintaining HTML documentation and that also permits conversion to a
printable medium for publishing as a manual?
What archive/single-source processes are others using?