Re: Modularization of Documentation

Subject: Re: Modularization of Documentation
From: eric -dot- dunn -at- ca -dot- transport -dot- bombardier -dot- com
To: techwhirlers <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 5 Jun 2006 12:39:58 -0400

Tony Markos <ajmarkos -at- yahoo -dot- com> wrote on 06/05/2006 11:53:20 AM:
> Are these books like all the books on structured
> writing that shout "Ya gotta have structure", without
> giving any specifics as how to structure?

You mean something like you own cries of "You must worship

If you discussed techniques and approaches instead of preaching like a
rabid tv evangelist, you might get a little more respect. But then again
to have people respect your approach/technique also means you have to
respect others.

In you diatribe against all other techwriters and the non-existence of any
other worthy approach or description there-of, how do explain DITA? That's
an entire documenting strategy based on modules. Other methods of creating
and managing the modules/chunks exist as well.

Now, to get to the modules we may not draw pretty diagrams that are up to
your standards, and we may not use a trademarked name for some of our
processes, but our approaches seem to work none-the-less.

Eric L. Dunn
Senior Technical Writer


This e-mail communication (and any attachment/s) may contain confidential
or privileged information and is intended only for the individual(s) or
entity named above and to others who have been specifically authorized to
receive it. If you are not the intended recipient, please do not read,
copy, use or disclose the contents of this communication to others. Please
notify the sender that you have received this e-mail in error by reply
e-mail, and delete the e-mail subsequently. Please note that in order to
protect the security of our information systems an AntiSPAM solution is in
use and will browse through incoming emails.
Thank you.

Ce message (ainsi que le(s) fichier/s), transmis par courriel, peut
contenir des renseignements confidentiels ou protégés et est destiné à
l?usage exclusif du destinataire ci-dessus. Toute autre personne est par
les présentes avisée qu?il est strictement interdit de le diffuser, le
distribuer ou le reproduire. Si vous l?avez reçu par inadvertance,
veuillez nous en aviser et détruire ce message. Veuillez prendre note
qu'une solution antipollupostage (AntiSPAM) est utilisée afin d'assurer la
sécurité de nos systems d'information et qu'elle furètera les courriels


WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!.

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at

You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

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

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.


Re: Modularization of Documentation: From: Tony Markos

Previous by Author: Re: OFF-TOPIC question about an office thing
Next by Author: Re: Using a warning notice for Television Owner's Manuals
Previous by Thread: Re: Modularization of Documentation
Next by Thread: Re: Modularization of Documentation

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

Sponsored Ads