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.
Subject:Windows Help/Future Demand From:Matthew Wong <wong -at- ACEC -dot- COM> Date:Tue, 11 Jan 1994 18:19:31 PST
Hello List,
While Kelly Hoffman is right in suggesting that the demise of printed
documentation is greatly
exaggerated, it is also true that the future of tech writers will extend beyond
paper
documentation, which leads me to the second issue of this message: On-Line Help
(specifically Windows Help facility)
Our documentation department has been tasked with developing the Windows help
facility for
all the Windows applications that are currently being developed by the company.
Undoubtedly,
on-line help and on-line documentation will become more and more the province of
tech writers.
Thanks to the help from this list, I was able to determine if there are any
Windows help
authoring tools that uses FrameMaker as their editing environment. The answer
seems to be
no. I realize that I can save the FrameMaker files in RTF and then use the Help
compiler
(HC.EXE, HC30.EXE, or HC31.EXE) to generate the hlp files.
Alternatively, I could use a Windows help authoring tool. These tools use
Microsoft Word for
their editing environment. The benefit of these tools is that it provides an
integrated package for
writing, coding, and compiling the Windows help.
For those of you on the list who are developing the help facility for Windows
applications I
would like to hear from you about:
1. Which of the two development routes would you recommend: (a) develop the RTF
file with
FrameMaker and then exeute the help compiler, or (b) use a Windows help
authoring tool.
2. What Windows help authoring tool would you recommend: (a) RoboHelp, (b)
Doc-to-Help,
(c) Help Magician, and what are your reasons for recommending/discouraging them.
3. How are you presently developing your Windows help ?