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: Print vs Online versions of same manual From:k k <turnleftatnowhere -at- yahoo -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 25 Mar 2004 12:55:12 -0800 (PST)
--- Greg Stenhouse <greg -dot- stenhouse -at- tait -dot- co -dot- nz> wrote:
>
> Hi David
>
> What you are proposing with Frame's conditional text
> and WWP is very common.
> Search the archives for "single-source", which will
> bring up lots of
> discussions for and against. In a nutshell (and this
> a very small and
> overly-simplified nut):
> * For: update the source only once, yet the press of
> a button means multiple
> deliverables like magic! Less work for you in the
> long term, and management
> will love you.
> * Against: you can never really do 100% justice to
> all deliverables (there
> is usually compromise to some extent).
>
I say go with the "For" argument regardless. Having
been stuck with several projects where I have to
manually update many different Word files whenever the
product is changed, I'd give much to be able to have
one set of keystrokes update all files at once.
I think this "against" statement is not entirely
accurate. The times that I used FrameMaker and WWP, it
was my experience that you can set things up so that
both the print manuals and the online help come out
exactly the way you want them.
The catch is, getting what you *really* want using a
single-source method takes a lot more work than making
compromises. It requires a lot of thought on things
like how the organization of a help system differs
from the print version organization. Then you have to
make sure the FM source files include everthing needed
to make it possible to boil down different versions.
That extra time on the setup end may not be worthwhile.
__________________________________
Do you Yahoo!?
Yahoo! Finance Tax Center - File online. File on time. http://taxes.yahoo.com/filing.html
ROBOHELP X5 - ALL NEW VERSION. Now with Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more!
Now is the best time to buy - special end of month promos, including:
$100 mail-in rebate; Free online orientation on content management
functionality; Huge savings on support and future product releases;
PLUS Great discounts on RoboHelp training. OFFER EXPIRES March 31!
Call 1-800-358-9370 or visit: http://www.ehelp.com/techwr-l
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -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.