RE: You Don't Need to Know How

Subject: RE: You Don't Need to Know How
From: "SHIELDS,SUSAN (HP-FtCollins,ex1)" <susan_shields2 -at- hp -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 25 Jul 2001 10:04:31 -0700

In response to my
:: KNOW YOUR AUDIENCE!

Bill Swallow said:
>I think the issue goes far beyond knowing your audience.

Sure. Knowing your audience is just one interesting point in the larger
discussion.

>Because your
>audience just needs to know what button to click, does not mean you only
>learn that much of the product.

I agree, sort of. That's why I followed with a caveat "...you probably don't
HAVE to have an
intimate knowledge of its inner workings -- although having that knowlege
might give you a perspective into troubleshooting, cautions, tips, etc."

>At the same time, knowing too much runs the
>risk most developers face: they are too intimate with the product and can't
>speak to it outside that scope.

I think technical writers should have a foot in both camps: keep the users'
perspective but be conversant with the technology. Be an information bridge
but also focus the information. And when the writer chooses a focus,
audience requirements should be a deciding factor.

>Also, I think it goes without saying that the more you know, the more
>marketable you are...

Maybe. Depends on what you know and what the market demands. More isn't
necessarily better.

Susan

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

*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com

Learn about tools and technologies for user assistance developers at
The Help Technology Conference, August 21-24 in Boston, MA
Details and online registration at http://www.SolutionsEvents.com


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


Previous by Author: RE: You Don't Need to Know How
Next by Author: Re: Acrobat 5.0 Creating Large PDF File Sizes
Previous by Thread: Re: You Don't Need to Know How
Next by Thread: RE: You Don't Need to Know How


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


Sponsored Ads