Re: know your ... who?

Subject: Re: know your ... who?
From: Ned Bedinger <doc -at- edwordsmith -dot- com>
To: "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
Date: Thu, 21 Feb 2008 15:58:14 -0800

McLauchlan, Kevin wrote:
> Anyway, I asked my original question because somewhere in the vast
> middle ground of writerly experience and access to users, people have
> tips and tricks and sources that some of us might not have considered,
> and I'd seen the mantra one time too many since last week. :-)

Anyway, the mantra is lifted from a larger context, a sutra if you must,
that describes the whole back and forth between writer and user. The
user must know the writer, too.

The fact that you can write the docs without knowing the user, and the
user can use the docs without knowing you, is a testimony to the power
of abstraction. If the details of the abstract user have been
anticipated and built into the product by omniscient engineers or added
later by empathic translators, you've got a charmed job.

If the support lines aren't ringing because your docs led to smoked
machines, it sounds like you can relax and enjoy the ride :-)

Ned "mantra ray"


>
> Kevin
> The information contained in this electronic mail transmission
> may be privileged and confidential, and therefore, protected
> from disclosure. If you have received this communication in
> error, please notify us immediately by replying to this
> message and deleting it from your computer without copying
> or disclosing it.
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


References:
know your ... who?: From: McLauchlan, Kevin
RE: know your ... who?: From: technical writing plus
RE: know your ... who?: From: McLauchlan, Kevin

Previous by Author: Re: OT? Community and tech writing in real life (was Re: Ambiguous words and Phrases)
Next by Author: Re: Writers job description/definition
Previous by Thread: RE: know your ... who?
Next by Thread: RE: know your ... who?


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


Sponsored Ads