Re: Have to know Programming to be able to write about it? -- NO

Subject: Re: Have to know Programming to be able to write about it? -- NO
From: Bruce Byfield <bbyfield -at- axionet -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 27 Feb 2003 09:52:29 -0800


Beth Agnew wrote:

The expert is often the worst person to write about their subject, because they no longer see it with the naivete of the new user.
Hence the manuals that leave out crucial steps because "tsk, everyone _knows_ you're supposed to do X before Y". Remember all those unusable manuals in the early days of computers? Written by computer experts, not communication experts.

The problem with experts isn't their expertise - it's the fact that they aren't writers. Most experts aren't very interested in writing, and they aren't used to thinking of how to shape their thoughts to any audience except other experts. In the rare cases in which experts are also writers, the result is far more useful than those produced by a writer without expertise or by an expert with no writing skills.

The trouble with not being an expert is that you don't know what you don't know. You have to rely on what you're given, and you often won't see the errors or gaps.

That said, there are various ways of gaining expertise. You don't have to come into a project with expertise. In fact, structuring your content and writing it is often an excellent way to gain understanding. However, by the time the project is finished, you should have at least a moderately high degree of expertise - and the more, the better.

Personally, that's the appeal of tech-writing. It gives me an excuse to explore all sorts of nooks and crannies that I would otherwise probably never get around to. Whenever someone talks about relying on SMEs, I have flashbacks to some of the university students I used to teach who seemed to see classes as a struggle that they would win if they could pass with only a minimum of learning. Yes, they could graduate that way, but only by cheating themselves. In the same way, if I didn't make a determined effort to gain as much expertise as possible about the subjects I write on, I'd be cheating myself by giving myself much less job satisfaction.

--
Bruce Byfield bbyfield -at- axionet -dot- com 604.421.7177
http://members.axion.net/~bbyfield


"A curse on the coppers, the judges, the screws,
Who torture the innocent and wrongly accused,
For the price of promotion a judgement to sell,
May the judged be their judges when they rot down in hell."
- The Pogues, "Birmingham Six"



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


LAST CHANCE for this steal of a deal! Purchase RoboHelp X3 by February 28
and receive $100 mail-in rebate and FREE WebHelp Merge Module ($339 value)!
RoboHelp, the Industry Standard in Help Authoring, has won over 55 industry
awards. For more information please visit: http://www.ehelp.com/techwr-l2.


"RoboHelp X3 is simply remarkable." - George Bell, Techno-Vision Systems


---
You are currently subscribed to techwr-l as:
archive -at- raycomm -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.



References:
RE: Have to know Programming to be able to write about it? -- NO: From: Matthew Horn
Re: Have to know Programming to be able to write about it? -- NO: From: Beth Agnew

Previous by Author: Re: Having a Life Re: Educational areas to pursue
Next by Author: Re: Subject Matter Expertise-YES!
Previous by Thread: Re: Have to know Programming to be able to write about it? -- NO
Next by Thread: Re: Have to know Programming to be able to write about it? -- NO


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

Sponsored Ads


Sponsored Ads