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: Conditional content - what do you do with it? From:"McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com> To:Keith Hood <klhra -at- yahoo -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>, "magk -at- mindspring -dot- com" <magk -at- mindspring -dot- com> Date:Wed, 12 May 2010 16:37:42 -0400
Keith Hood typed:
> Nothing is perfect.
You're talking about my eyes?
> I make a lot of use of variables so I can
> update things automatically. And when I say duplicate
> content, I mean immediately adjacent. I figure it's easier to
> change sentences in two paragraphs right next to each other
> than to deal with a jumble of condition tags. To each his own.
I've been tending that way, lately... ever since my eyes
got old, last month. . . :-)
Seriously, that arrangement seems to be the best bet.
I haven't yet decided if I might make an exception for
product names.
Once upon a time, that would have been a frequent thing
to deal with, but I've been steadily replacing most
occurrences of <some-product-name>/<some-other-product-name>
with generic wording such as "your HSM" or "the HSM server",
etc., as appropriate.
It gives me much less grief, and the visuals are ever-so-much
less cluttered.
It's good to see other people's perspectives and suggestions.
I can't really act on suggestions to use a different HAT,
but restraining myself to conditional blocks no smaller
than a full paragraph is probably the biggest help.
Cheers,
- Kevin
The 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.
Use Doc-To-Help's XML-based editor, Microsoft Word, or HTML and
produce desktop, Web, or print deliverables. Just write (or import)
and Doc-To-Help does the rest. Free trial: http://www.doctohelp.com
- Use this space to communicate with TECHWR-L readers -
- Contact admin -at- techwr-l -dot- com for more information -
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-