Re: Cheicken and eggs scenario for structred writing

Subject: Re: Cheicken and eggs scenario for structred writing
From: "Peter Neilson" <neilson -at- windstream -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 24 Jul 2013 05:48:40 -0400

On Wed, 24 Jul 2013 04:36:11 -0400, David Harrison <dharrison -at- moldmasters -dot- com> wrote:

* same user manuals with subtle variants

It's those subtle differences that'll kill you. You may discover that three manuals, identical to start with, have grown localized variations and are now basically incompatible with each other. Worse, an entire subset of them are known by the same part number, owing to a bad ad-hoc decision or to a difficulty in obtaining separate part numbers. To update one paragraph that appears, in various guises, in 23 of the 37 similar manuals may require the careful attention of three writers (one of whom knows Canadian French) for four agonizing months. See if you can find a tool that'll keep a mess like that sorted out properly!

Here endeth another of my jaundiced views of tech writing.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

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

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-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
Cheicken and eggs scenario for structred writing: From: David Harrison

Previous by Author: Re: Comma question
Next by Author: Re: how to handle power point slides?
Previous by Thread: Cheicken and eggs scenario for structred writing
Next by Thread: Re: Cheicken and eggs scenario for structred writing


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

Sponsored Ads


Sponsored Ads