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:Re: Help -> Manual or Manual -> Help From:Lisa Higgins <lisarea -at- DRUAK -dot- DR -dot- LUCENT -dot- COM> Date:Wed, 13 Aug 1997 13:51:24 +0000
So then, Christine Jesensky is all like:
> I'm having trouble translating from the hypertext, non-linear viewpoint
> to a narrative, linear viewpoint. In particular, transitioning from one
> topic to the next and eliminating redundancy are bothering me.
That's like trying to edit a porno movie for general release. Good
online help has no plot, no extraneous dialogue, and it gets right to
While you may be able to use chunks of the online information, trying
to write around a storyline that consists of people walking into
rooms and saying, "Hey, mind if *I* join you?" is going to be
difficult at best.
In other words, start from scratch and then recycle what you can as
you go along.
Oh, yeah, and remember to cut out all the twangy disco music.