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: Mapping, Single Sourcing, odd situation From:Tim Altom <taltom -at- SIMPLYWRITTEN -dot- COM> Date:Tue, 29 Jun 1999 09:19:04 -0500
Wow. Great thread.
>> By the way, the ability to leverage related sets of information in such a
>> manner is one of the strongest arguments for using a database approach to
>> Single Sourcing of certain kinds of documentation.
In her previous post, Gwen included the text from someone disagreeing with
her about single sourcing. That person objected to single sourcing as just
an excuse to burden the user with identical wording, just in different
That is not, repeat not, Simply Written's approach to single source and the
Clustar method. Huh-uh. Clustar does, indeed, require some compromises. So
does every system. In Clustar's case, it requires the writer(s) to be
extremely conscious of structure and be consistent "tho the heavens fall".
But the system also permits us to reuse vast amounts of text and "data" in
different areas and formats. A Clustar training manual doesn't have the same
stuff as a Clustar software manual, even for the same product.
If people are thinking that single sourcing means to just type once and
translate to HTML, that's not our view. Rather, we view single source as
writing information in ways that are *designed from the start* as
multi-output, because they're separable. The pieces can be reused in
infinite combinations. And we stress tasks, not data like field definitions.
We here firmly believe that single source, while definitely a boon to the
client's budget, is also easier to read, simpler to navigate, and much more
effective, if only because it focuses the writer on what's important and
doesn't encourage fishing expeditions. "Narrative" manuals are fun and often
artsy, but they're also frustrating as all get out for users who need task
Simply Written, Inc.
Featuring FrameMaker and the Clustar Method(TM)
"Better communication is a service to mankind."