RE: Single-sourcing a procedure for multiple uses

Subject: RE: Single-sourcing a procedure for multiple uses
From: "Leonard C. Porrello" <Leonard -dot- Porrello -at- SoleraTec -dot- com>
To: "Blount, Patricia A" <Patricia -dot- Blount -at- ca -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 25 Sep 2008 08:19:53 -0700

This might be out of scope, but I'd suggest you get a better
single-sourcing application. I do exactly what your talking about very
easily using "conditional text" flags and variables in Help & Manual.
And although I prefer H&M to Flare, I think Flare has similar
functionality.

Leonard

-----Original Message-----
From: techwr-l-bounces+leonard -dot- porrello=soleratec -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+leonard -dot- porrello=soleratec -dot- com -at- lists -dot- techwr-l -dot- c
om] On Behalf Of Blount, Patricia A
Sent: Thursday, September 25, 2008 7:23 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Single-sourcing a procedure for multiple uses

Good morning, writers,

I have a writing challenge and need the wisdom of your collective
experience.

One of software products I'm documenting can be used with about ten
different 3rd party applications. Each application currently has its own
guide, and each guide currently contains its own distinct version of the
same procedure.

There are some very minor differences within that procedure, depending
on the application you're using. For example, you would select the
desired application from a list of all supported applications. In this
example, I've genericized as many steps as possible, changing the
wording of a step like this:

From: "Choose <ApplicationNameA> and then click Next.
To: "Choose the application you wish to protect from the list below and
then click Next."

Here's my dilemma. There's additional pertinent information in this
procedure that applies ONLY to use of one particular application, not
the whole list. In some cases, there may even be additional steps not
present in that procedure for other applications.

I'm having trouble single-sourcing the procedure to meet all my needs.
I'm using AuthorIT. I thought about creating a topic from every step in
the procedure and then stringing them together. That would allow me to
insert extra steps and information as needed. The problem is formatting.
AIT numbers everything as "1" unless it's contained within the same
topic.

I also thought about picking one application from the list and using it
as the example throughout, but Management wants specifics in each Guide.


So far, my rather inelegant solution is to store each step as its own
object, then embed each object into a Procedure for each Guide. Embedded
objects will still be modified across all books when the sources change,
so that gives me some single-sourcing benefit. Plus, it allows me to
insert the unique information between embedded objects.

I wondered if anyone has a better solution.

Many thanks,
Patty B
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial.
http://www.componentone.com/DocToHelp/

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as
Leonard -dot- Porrello -at- soleratec -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/leonard.porrello%40so
leratec.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

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

ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial.
http://www.componentone.com/DocToHelp/

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


Follow-Ups:

References:
Single-sourcing a procedure for multiple uses: From: Blount, Patricia A

Previous by Author: RE: "Up with which I will not put" (was: RE: "and then, " or simply "then"?)
Next by Author: RE: Single-sourcing a procedure for multiple uses
Previous by Thread: Re: Single-sourcing a procedure for multiple uses
Next by Thread: Re: Single-sourcing a procedure for multiple uses


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


Sponsored Ads