Re: Technical Documentation solutions?

Subject: Re: Technical Documentation solutions?
From: Andrew Plato <gilliankitty -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 28 Aug 2002 19:43:27 -0700 (PDT)

"Manley Clifford (GFD1CEM)"

> modular single-sourced dynamic cost-effective documentation
> should be all of ours.

No it shouldn't. ACCURATE & USEFUL documentation should be everybody's goal. How
that is produced is virtually irrelevant. Nobody in the world is going to care
how that data got to them, just that it did. So don't fool yourself into thinking
that some elaborate system will make the information suddenly more effective. If
you shove garbage into this system you will produce garbage. And since most
engineers could care less about documentation...well the odds are against you.

However, if you need a massive process to generate content and if your employer
is willing to pay for you to spend your time building it, then have fun.

But don't ever assume that your methods are universally useful or acceptable.
Many organizations would consider the type of system your building an absolute
waste of resources.

Modular, single-sourced, dynamic, and cost-effective are not all synonymous
terms. There are plenty of writers in the world producing extremely
cost-effective documentation and there isn't a shred of "single-sourcing" being

Andrew Plato

Do You Yahoo!?
Yahoo! Finance - Get real-time stock quotes

Want to support TECHWR-L? Get shirts, bags, hats, clocks,
and more from the TECHWR-L Store. All proceeds support TECHWR-L.

Check out the new release of RoboDemo, our easy-to-use tutorial software.
Plus, buy RoboHelp Office in August and save $100 with our mail-in rebate.
Get details and download free trial versions at

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 for more resources and info.

Previous by Author: Re: Technical Documentation solutions?
Next by Author: RE: Technical Documentation solutions?
Previous by Thread: Re: Technical Documentation solutions?
Next by Thread: RE: Technical Documentation solutions?

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

Sponsored Ads

Sponsored Ads