Help! Documenting customizable software

Subject: Help! Documenting customizable software
From: The Tech Writer <techwrtr -at- CRL -dot- COM>
Date: Tue, 30 Jan 1996 14:02:44 -0800

I am feeling rather overwhelmed. Hopefully, some advice from the list
will help me to feel a little more confident in pursuing my present project.

I have just inherited the documentation for a totally configurable software
application (large and expensive, intended for hospitals). This program
is, like, the most un-shrinkwrapped software I've ever seen.

Fact #1: The hospital is given the source code for the online and paper
documentation. We have to make both easy for them to configure
according to the way they set up the software.

Fact #2: The hospital can choose whether or not to use whole modules.
Okay, that's not too hard to document, I guess.

Fact #3: The hospital can choose parts and pieces of modules. Things are
getting tougher.

Fact #4: The hospital can actually change captions on dialog boxes. They
can change the names of dialogs. They can choose what types of
controls to use on the dialogs (such as list box vs. drop-down
list box). WHAT?!?!

Long List of Questions
======================
Have any of you tackled this type of project?

If so, what techniques/conventions did you use/follow?

How did you determine where your duties left off and the purchasing
agency's began?

How did you handle upgrades to the documentation so that they didn't
overwrite the work that the purchaser made?

How did you make it easier for the purchasing agency to modify the source?

How did you organize your files?

How did you handle descriptions of dialogs without using graphics?

When did you use graphics, even though they wouldn't match what the user
had?

Did your company provide technical support for documentation modification?

If so, what kind of person took those calls?

Did you find any software that made the project easier?

Thanks to anyone who can offer any kind of assistance on this. If you
have answers to questions that I hadn't even thought to ask, yet, please
feel free to include them in any responses. If anyone is interested in
how I solve any of these problems, let me know, and I will summarize
either to the list, or to a list of individuals.

-David Castro
techwrtr -at- crl -dot- com
http://www.crl.com/~techwrtr/


Previous by Author: IPCC '96
Next by Author: Re: WinHELP Philosophy
Previous by Thread: Online discovery!
Next by Thread: HUMOR: Word 6.0 Tips fo the Day


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

Sponsored Ads


Sponsored Ads