Re: waking up to the world of Technical Writing

Subject: Re: waking up to the world of Technical Writing
From: "Mark Baker" <listsub -at- analecta -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 3 Jun 2004 09:48:21 -0400


> Is it just me out on the bleeding edge or have a lot
> of people been asleep lo these 51 (going on 52) years?

Well, you can hardly expect the conference to be cutting edge when proposals
have to be submitted almost a year in advance. You have to stick to old
chestnuts because anything contemporary or cutting edge risks being
out-of-date by this time next year.

But the thing that really gets to me about this announcement is in the next
paragraph:

"You are invited to be part of this vision of technical communication as
central to every user experience."

This seems to me to miss the point entirely. Technical communication is, by
its very nature, peripheral to and even an interruption of the user
experience. This is the first thing that I used to stress to new writers:
unlike most other forms of writing, your purpose is not to grab and hold the
user's attention, it is to get them out of the book and back to their task
as quickly as possible. The less they have to read, the better. If technical
communication becomes central to the user's experience, then something has
gone terribly wrong.

The novelist knows he has done a good job when the reader finishes his book
with a sigh of contentment. The technical writer knows he has done a good
job when the workman finishes his project with a sigh of contentment.
---
Mark Baker
Analecta Communications
www.analecta.com
+1 613 614 5881



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

SEE THE ALL NEW ROBOHELP X5 IN ACTION: RoboHelp X5 is a giant leap forward
in Help authoring technology, featuring Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more! http://www.macromedia.com/go/techwrldemo

>From a single set of Word documents, create online Help and printed
documentation with ComponentOne Doc-To-Help 7 Professional, a new yearly
subscription service offering free updates and upgrades, support, and more.
http://www.doctohelp.com

---
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.



Follow-Ups:

References:
waking up to the world of Technical Writing: From: T. Word Smith

Previous by Author: Your TECHWR-L message
Next by Author: Re: waking up to the world of Technical Writing
Previous by Thread: RE: waking up to the world of Technical Writing
Next by Thread: Citrix: are you using it for technical writing or in general, thoughts?


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


Sponsored Ads