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.
Some top-of-my-head comments:
1) writing for WIN-HELP -- Take time before you begin writing to design a
help model that fits your situation. Specifically, think about how the user
will use hypertext to navigate, what entry points you'll have, the types of
information you're presenting (procedural, glossaries, context-sensitive
field or window help, etc.), the kinds of windows you'll use. Do some
prototyping (start with paper prototypes and later move to a WinHelp one),
and have some real-life users test them and give feedback. Set standards
and adhere to them. After you've made some of these decisions, then you
should start evaluating tools; otherwise, you may find you have to
compromise your vision in order to fit the constraints or world-view of a
2) the pros and cons of using WIN-HELP -- On the plus side, the viewer
comes with every installation of Windows. On the minus side, the viewer
comes with every installation of Windows--but no other platforms. Granted,
there are viewers for other platforms available, but not for free.
WinHelp is a powerful hypertext delivery application, and the cost to get
started is minimal. There are many excellent authoring tools available, but
you can get by with nothing more than Notepad, Word for Windows, and the
help compiler. And there are plenty of extensions available if you want to
start adding custom features and multimedia.
Hope that helps.
rjacobse -at- gps -dot- com
Date : 08/12/97 10:35 AM
To : TECHWR-L @ LISTSERV.OKSTATE.EDU
cc : (bcc: ScribeTribe)
Hello all. I am coming out of "lurk" mode to solicit some information on
Here at my organization we are anticipating the development of several
Window-based applications for our company's Intranet site that will
a Help facility. I am part of a group of writers who will be responsible
for writing the information for whatever Help facility we choose, and we
currently looking into WIN-HELP.
Any information specifically on
1) writing for WIN-HELP
2) the pros and cons of using WIN-HELP and
3) any additional references that would be helpful (e.g. listservs, books,
would be greatly appreciated.
SUNY Research Foundation
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html