RE: Using conditions in multi-destination docs

Subject: RE: Using conditions in multi-destination docs
From: "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
To: Spectrum Writing <info -at- spectrumwritingllc -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 23 Dec 2009 11:37:09 -0500



> -----Original Message-----
> From: Spectrum Writing [mailto:info -at- spectrumwritingllc -dot- com]
> Sent: Tuesday, December 22, 2009 3:43 PM
> To: McLauchlan, Kevin; techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: RE: Using conditions in multi-destination docs
>
> The only warning/caveat that I see:
>
>
> "Your [Prod1][Prod2] arrives from the factory with default
> network settings. Before using the appliance configure
> for your network as follows:
>
> From personal and frequent experience, conditionalizing
> [Prod1][Prod2] right
> in the middle of a sentence with two conditions can get
> tricky and messy,
> especially if you don't conditionalize the necessary spacing
> before and
> after correctly and it results in a lot of extra cleanup/fix time.
>
> My suggestion:
>
> "Your [Prod1]arrives from the factory with default
> network settings. Before using the appliance configure
> for your network as follows:
>
> "Your [Prod2] arrives from the factory with default
> network settings. Before using the appliance configure
> for your network as follows:
>
> and conditionalize each statement with Prod1condition or
> Prod2condition as
> appropriate. This approach can save you lots of grief and
> time later on!


That's a good suggestion, especially with MadCap Flare, which
makes it vary easy (one click) to select a free-standing block,
but harder to accurately select from within a para, particularly
when conditions overlap.

It does require a bit more writing (not much with cut'n'paste)
but probably saves time in the long run. Much clearer to read,
on-the-fly, months later.

Sold.

Thanks,

- KevinThe information contained in this electronic mail transmission
may be privileged and confidential, and therefore, protected
from disclosure. If you have received this communication in
error, please notify us immediately by replying to this
message and deleting it from your computer without copying
or disclosing it.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
http://www.doctohelp.com/

Help & Manual 5: The all-in-one help authoring tool. True single- sourcing --
generate 8 different formats and as many different versions as you need
from just one project. Fast and intuitive. http://www.helpandmanual.com/

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


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
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Using conditions in multi-destination docs: From: McLauchlan, Kevin
RE: Using conditions in multi-destination docs: From: Spectrum Writing

Previous by Author: RE: Using conditions in multi-destination docs
Next by Author: RE: Using conditions in multi-destination docs
Previous by Thread: Re: Using conditions in multi-destination docs
Next by Thread: Re: Using conditions in multi-destination docs


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


Sponsored Ads