Re: waking up to the world of Technical Writing

Subject: Re: waking up to the world of Technical Writing
From: dmbrown -at- brown-inc -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 03 Jun 2004 08:28:27 -0700

Mark Baker wrote:

...the thing that really gets to me about this announcement...:

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

I think you're assuming too narrow a definition of technical communication, even if we limit the discussion to software-related technical communication.

The fortunate tech writers are increasingly involved in development of the UI--at least in terms of command names, object labels, tool tips, and the like; sometimes even in workflow design.

That's very much central to the user experience.

You point of view is evident in the statement about getting them "out of the book and back to their task," but tech writers do more than just producing books.



A V A I L A B L E N O W !

HTML Indexer is still the easiest way to create and maintain real indexes
for web sites, intranets, HTML Help, JavaHelp, and other HTML documents.


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

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


waking up to the world of Technical Writing: From: T. Word Smith
Re: waking up to the world of Technical Writing: From: Mark Baker

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

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

Sponsored Ads