Change Management dilemma (Install Guide v. Software Updates)

Subject: Change Management dilemma (Install Guide v. Software Updates)
From: "Jill Mohan" <jillemo -at- gmail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 26 Feb 2008 16:08:28 -0500

I am hoping to find a guru to lead me to my answer.

I have written an Installation Guide for the system we delivered to the
government. We keep releasing updates to the system software...

- some of these updates are Manufacturer updates (such as Oracle
patches, Java patches, etc.),
- some are updated scripts to enhance functionality which take us from
one baseline version to the next baseline version, and
- still others are just data dumps that are fed into the system.

I'm thinking I may have my answer... only those updates which enhance
functionality are captured in the Build Guide update for that respective
baseline version, correct?

IMHO, the Govt is preoccupied with this end-of-the-world business. So they
worry that if civilization were wiped out, would my Build Guide bring them
up and running to the baseline version on record? Which is a tricky
question, because if I only include our enhanced functionality upgrades,
then...i guess i need to put a pointer to check this other document for any
other updates that apply to the system?
Am I on the right track?

Thanks for answering my musings.

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Previous by Author: Peer Review Process/Best Practices
Next by Author: RE: Writers job description/definition
Previous by Thread: Re: Peer Review Process/Best Practices
Next by Thread: Reading level guidelines for (translated) training material

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

Sponsored Ads