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:Summary: Creating Online Help From:Jennifer Zilliac <jennifer -at- SMARTDB -dot- COM> Date:Wed, 17 Dec 1997 13:34:45 -0800
WOW! Thanks for all the helpful help help!
People really came through with detailed, useful suggestions.
Here is a brief summary:
There was overwhelming consensus about how to put docs online:
Go with Adobe Acrobat. The viewer is free, and if we upgrade
to FrameMaker 5.5, we'll get Acrobat included.
I should create a separate template for use with online docs.
This template should be smaller and possibly use different
fonts -- fonts that are easier to read online an ones that
our customers are likely to have.
The online version of the documents should be more minimalist.
Most people felt that three months is not enough time to create
a new help system given that I have not done it before and that
I still have a full load of paper books to get out. People
tended to think that if I tried it, the result would be poor.
I need to allow plenty of time to test every link.
I received two suggestions for products other than RoboHelp: Forehelp
and WebWorks -- WebWorks only if we want to go with HTML instead
of WinHelp. I'm leaning toward WinHelp right now, but I'd be
interested in hearing arguments for HTML.
I also received suggestions for online resources that I plan to
check out today: