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: Keeping up w/ design From:Dan Glovier <Mailbox!tsh!dan -at- MCS -dot- NET> Date:Mon, 23 Jan 1995 11:36:49 -0600
The Gods overheard Scott McDaniel state:
<snipped background info for brevity>
> The problem I'm wrestling with: the system is still in development,
>and features change as fast as I can keep up with them. It is not
>evolving toward a specific final form. How have you dealt with
>situations like this?
Here's what we do when we face documenting "vaporware."
1) We try to avoid it.
2) That being impossible, the best we have come up with is taking a modular
approach to the production of the documentation. We get an overall explanation
the product will do, how the different pieces fit together, and then we document
the most "stable" pieces first.
3) Honest communication. E-mail, e-mail, and more e-mail. Updates are given to
as soon as they happen. When they think they will be changing something, they
inform us of these upcoming vapor changes to avoid time-consuming changes.
4) Keep your superiors aware of these changes as they happen (if they are
That way, when the project is done and they are wondering why you haven't
documented the 20
last-second changes that they have made, your boss knows that you have been
with these changes, and that it WILL be completed (and perfect!) shortly.
Keeping it in small bits, communicating with the developers, and keeping your
superiors aware of your progress are about the best you can do in this
If anyone else has any insights, please share!
dan -at- tsh -dot- com
"Yeah I got faith, but sometimes fear it just weighs too much."
- "Cold Feelings" Social Distortion