RE: Baiting for the single source rant

Subject: RE: Baiting for the single source rant
From: "Swallow, William" <WSwallow -at- courion -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 6 Sep 2001 09:10:23 -0400

<snip>Single sourcing works (or can work) but it's a trade-off. When I've
created manuals and online docs (help, online manuals etc) I have NEVER
simply used exactly the same text/structure etc for both. It can be done
but only by compromising the quality of one/all. It all depends on how big
the compromise is and how that compromise fits in with saving on time
etc.</snip>

Again, that's repurposing, not single-sourcing. Single-sourcing does not
involve a compromise; it's a different way of looking at documentation. I'll
be the first to admit that you cannot write a document with the intention
that it will be printed, bound, and shipped, and then turn around and put
the same exact content into online help.

Single-sourcing involves thought, planning, structure, and flexibility.
(Please note that the only part any tool can help you with is the
flexibility part.)

*****************
BILL SWALLOW
Technical Writer
C O U R I O N C O R P O R A T I O N
1881 Worcester Road
Framingham, Mass. 01701
T E L * 508-879-8400 x316
F A X * 508-879-8500
www.courion.com
*****************
THIS EMAIL CONTAINS CONFIDENTIAL INFORMATION
MEANT FOR THE INTENDED RECIPIENT ONLY. PLEASE
DELETE THIS IF YOU HAVE RECEIVED IT IN ERROR.

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

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: RE: Single Sourcing
Next by Author: RE: Baiting for the single source rant
Previous by Thread: RE: Baiting for the single source rant
Next by Thread: RE: Baiting for the single source rant


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


Sponsored Ads