RE: Rewriting and Streamlining

Subject: RE: Rewriting and Streamlining
From: "Jane Carnall" <jane -dot- carnall -at- digitalbridges -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 1 Mar 2002 17:22:41 -0000

Geri Lou Ciotoli has been assigned <<the task of rewriting and streamlining
an existing
manual set (of approx 6000 pages) and I'm having trouble figuring out how to
begin. <snip description> I need to rewrite these manuals to be more
procedural and useful to the users. <snip> I'm thinking of just setting
aside the manual and work completely from the software .. but I think that
might be throwing away valuable information and creating more work for

I've had some experience with a similiar situation, and agree that it's
better to create a new outline and use the old manual as a reference while
working from the software. But also, if it's a 6000 page manual written in
linear fashion, I will lay money that it includes some outdated screens and
deprecated functions that have not been updated because no one has happened
to check. By using the software as primary reference and the old manual as
secondary reference, you can clear up and correct any outdated information
in the old manual, and that in itself is added value.

Jane Carnall
The writers all stand around a cauldron chanting and occasionally tossing in
a very large manual. Unless stated otherwise, these opinions are mine, and
mine alone. Apologies for the long additional sig: it is added automatically
and outwith my control.


E-mail is an informal method of communication and may be subject to data corruption, interception and unauthorised amendment for which Digital Bridges Ltd will accept no liability. Therefore, it will normally be inappropriate to rely on information contained on e-mail without obtaining written confirmation.

This e-mail may contain confidential and/or privileged information. If you are not the intended recipient (or have received this e-mail in error) please notify the sender immediately and destroy this e-mail. Any unauthorized copying, disclosure or distribution of the material in this e-mail is strictly forbidden.


Now's a great time to buy RoboHelp! You'll get SnagIt screen capture
software and a $200 onsite training voucher FREE when you buy RoboHelp
Office or RoboHelp Enterprise. Hurry, this offer expires February 28, 2002.

You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Rewriting and Streamlining: From: Geri Lou Ciotoli

Previous by Author: RE: I suppose this is my most frustrating grammar error
Next by Author: RE: What a predicament!
Previous by Thread: Re: Rewriting and Streamlining
Next by Thread: RE: Rewriting and Streamlining

What this post helpful? Share it with friends and colleagues:

Sponsored Ads