Single Sourcing

Subject: Single Sourcing
From: "Eric J. Ray (remote)" <ejray -at- raycomm -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 5 Sep 2001 15:43:12 -0600 (MDT)


<ALL>Fighting amongst ourselves</ALL>

<HC>
Fighting effectively requires careful lack
of attention to detail. By following the instructions
in this section, you will be able to get started.</HC>
<HC and linkable chunk>
Note: You can learn more
about fighting techniques
by scanning the archives for ADMIN messages,
then looking at the messages immediately preceeding
the ADMIN message. This will give you insight
into the techniques that raise to the level of
the listowner's attention--more subtle or
nuanced techniques may not be so readily identifiable.</HC
and linkable chunk>

<HC and ONLINE>To fight in conventional ways, do the following:
1. Snipe.
2. Misquote.
3. Overgeneralize.</HC and ONLINE>
<ONLINE>See (link to preceeding note section) for more about
fighting techniques.</ONLINE>

<HC and ONLINE>See also Fighting with others(link) and Fighting
alone(link). </HC and ONLINE>

etc.

The advantages of _effective_ single sourcing are that
you repurpose content (using the same words in
two or more places) ensure consistency and
eliminate duplication of effort. There's really no sense in
having one writer write the "To fight in conventional
ways" section two different times, one for hard copy and
another for online. There's even less point in having
multiple writers each prepare that section for their
respective information products.

Yes, it can sometimes be a time suck. But it can also be really
effective and useful, and result in good online and hardcopy
docs. Tools to support this are sadly lacking, though--
Frame and conditional text works, but it's far from
ideal.

Eric
ejray -at- raycomm -dot- com



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

A landmark hotel, one of America's most beautiful cities, and
three and a half days of immersion in the state of the art:
IPCC 01, Oct. 24-27 in Santa Fe. http://ieeepcs.org/2001/

+++ Miramo -- Database/XML publishing automation. See us at +++
+++ Seybold SFO, Sept. 25-27, in the Adobe Partners Pavilion +++
+++ More info: http://www.axialinfo.com http://www.miramo.com +++

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Previous by Author: ADMIN: Don't ascribe to malice that which can ...
Next by Author: Re: question on speedy collection of engr info
Previous by Thread: Infoprint?
Next by Thread: RE: Single Sourcing


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


Sponsored Ads