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: FWD: One User's Guide for Multiple Products From:Sybille Sterk <sybille -at- BOFFIN -dot- BEYOND2000 -dot- CO -dot- UK> Date:Tue, 6 Jul 1999 15:15:10 +0100
I used to work on a manual that applied to three different versions of the
program - Lite, Standard and Advanced. Luckily, I didn't have the problem
that some options had implications on others - at least not in a way which
would make the manual very difficult to read.
Our manuals are structured in the following way that you first get to know
what the program does, a quick overview of the user interface and then a
detailed description of the menus and dialogs. At the beginning of the
manual I explained about the three different versions and later on added a
note to each option that was only available to lite, standard or advanced
or a combination of two versions.
This seemed to work alright, at least we didn't have any complaints.
However, if there are complex and complicated structures between the two
versions, I'd suggest two manuals, it'll be easier to work on and in the
end much quicker to update. You can write the Standard version first and
then delete the stuff you don't need for the Lite version and make any
amendments necessary to the second version. When you update them, just copy
and paste the bits that are the same in both versions between the two of them.
In my opionion the approach of a multi-project manual / documentation is
useful if the differences are straight forward, the more complex they are,
though, the more difficult for the user (and the author) to find out what
Hope this helps,
Technical Author and Translator (German)
email: sybille -at- boffin -dot- beyond2000 -dot- co -dot- uk