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:Glen Accardo <glen -at- SOFTINT -dot- COM> Date:Sun, 22 Jan 1995 12:47:21 -0600
> 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?
I've been in, and am still in, that situation. Here is the simple
(simple minded?) advice I have for you:
1. Never make a promise.
You can't write instructions for something that isn't designed yet.
If they aren't done thinking about it/mucking with it, neither are
you. Try giving estimates as "Once you've brought the system into
a stable, finished state, then I can estimate the writing/time
involved." Note that "stable, finished" does't mean perfectly
final, but close enough for screen captures.
2. Only work on stuff that's done.
Besides involving yourself in fewer rewrites, you also get to wait
until other stuff gets done.
3. Talk to everybody everyday.
This is the best way to find out when "done" is really gonna happen.
Besides, it's a good practice to keep up with the rest of development.
4. Learn to develop things "bottom up."
Most people like to start with the big picture, make an outline, then
fill in the details. Try starting with the known details, and piecing
them together as best you can. This takes a bit of publishing wizardry,
to rearrange text super-quick, but at least you are making use of the
time and information currently available and working towards a
complete manual. Note, this is easier to do when you'll deliver the
information online as opposed to print.
------------
glen accardo glen -at- softint -dot- com
Software Interfaces, Inc. (713) 492-0707 x122
Houston, TX 77084