RE: Single source

Subject: RE: Single source
From: "Brierley, Sean" <Sean -at- Quodata -dot- Com>
To: "'techwr-l -at- lists -dot- raycomm -dot- com'" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 29 Sep 2000 10:26:54 -0400


Once source document used without modification to create several output
types, say online help, printed output, output targeted at different
audiences, such as novice, intermediate, and advanced.

That is, from one document and without editing or tweaking that document
various different deliverables are created. This might involve more than one
software package but the key is there is only one source to maintain and
update as things change.

I am doing this now, quite successfully, using Adobe FrameMaker (with its
conditional text feature) and Quadralay WebWorks Publisher Pro. It is also
possible . . . though I know of no examples and certainly it would not be
inexpensive . . . to do this with a database and render via XML. Miramo is
some software that reportedly uses FrameMaker to expand these possibilities
. . . for about a $10k price of entry.

You must consider, though, how you write your document and how you structure
it. Just as you would structure a document for print only, or structure a
document only for online help output, so, too, you must structure a
single-source document for single-sourcing. I stress this is not really a
compromise but a specific targeting of a format based on your goal:
single-source documentation. Once achieved, you have met your audiences'
needs and also your own needs for ease of maintenance and resources, such as
staffing, budget, time . . ..

Best regards,

sean -at- quodata -dot- com

> -----Original Message-----
> From: Arthur Schweke [SMTP:tekritelist -at- hotmail -dot- com]
> Please define single source for me.
> Thank you.

Previous by Author: RE: best application for taking screenshots (Windows)
Next by Author: RE: Ventura, FrameMaker, ...
Previous by Thread: Single source
Next by Thread: RE: Single source

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

Sponsored Ads

Sponsored Ads