Referring to the name of a system

Subject: Referring to the name of a system
From: "Caroline Tabach" <caroline -dot- tabach -at- gmail -dot- com>
To: "techwr-l List" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 16 Oct 2007 13:43:25 +0200

I am documenting a safety instructions, unpacking and assembly for a
hardware box (unit), which has a different name when it is part of
different systems.
i.e, when it is part of the Toyshop System, it is called the AB1000 ,
When it is part of the Airplane system it is called the CD7000,
When it is part of the Railway System is the called the MN2000. (all
names and numbers are imaginary)

The person before me set up the 3 files (in FrameMaker) using
conditional text. If you are running Toyshop apply Toyshop condition
and the word AB1000 appears everywhere, etc.

I am now adjusting the documentation for the new use of Railway system
using MN2000, this is theoretically pasting in the conditionalized
word MN2000 next to the first 2 conditions.

I was wondering, is it possible to not use the name of the unit at
all. Just refer to it every time as "the unit"

Would there be a better way of doing it?
What is the difference between using a variable and using a condition
(apart from the fact using a condition I can see exactly what is going
on, as well as the fact that it would be a lot of work to change it)

Caroline Tabach
Technical Writer
e-mail: caroline -dot- tabach -at- gmail -dot- com

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: Re: Electronic (mis)communication
Next by Author: Re: Workflow for a release
Previous by Thread: Re: TECHWR-L Digest, Vol 24, Issue 15
Next by Thread: RE: Referring to the name of a system (aka FrameMaker Variables vs. Conditional Text)

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

Sponsored Ads