Re: Technical Writing - What's the catch?

Subject: Re: Technical Writing - What's the catch?
From: Dick Margulis <margulisd -at- comcast -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 01 Apr 2005 14:06:30 -0500




Lou Quillio wrote:

[snipped]

Brian Jennings wrote:

Orwell says a writer should ask himself:
1. What am I trying to say?


Dick Margulis wrote:


For most of us the questions are something more like this:
1. What is the audience?
2. What information do they need?



I must be missing something, because these lists look alike to me. Dick's list even appears to be (displays as? ;) a subset of Orwell's.


Lou,

Yes, you appear to be missing something. Orwell is focusing on what _I_ (first person, the writer) am trying to say. Tech writers (most of us) are focusing first on the expectations of the audience ( = _other_, third person). I'm not arguing with Orwell at all; I'm just saying the list Brian quoted is focused on _self-expression_ rather than on _knowledge transfer._ Different purpose, different list. That's all.

Dick

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

WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo:
http://www.webworks.com/techwr-l

---
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- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



Follow-Ups:

References:
RE: Technical Writing - What's the catch?: From: Brian Jennings
Re: Technical Writing - What's the catch?: From: Dick Margulis
Re: Technical Writing - What's the catch?: From: Lou Quillio

Previous by Author: Re: Documenting Hardware....yikes
Next by Author: Talk about penny wise and pound foolish!
Previous by Thread: Re: Technical Writing - What's the catch?
Next by Thread: Re: Technical Writing - What's the catch?


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


Sponsored Ads