TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: Why didn't they ask US for help??? From:Keith Hood <klhra -at- yahoo -dot- com> To:techwr-l -at- lists -dot- techwr-l -dot- com, "Downing, David" <DavidDowning -at- users -dot- com> Date:Mon, 25 Aug 2008 09:41:12 -0700 (PDT)
It doesn't necessarily have anything to do with politics or egos. Most people simply don't realize just how bad they are as writers.
Also, they are too familiar with the material. The guys who did up that procedure are not accustomed to thinking about how to walk people through things. They are so familiar with the procedure, they just don't see branch points because to them it's become so automatic they can't not pick the right course through the procedure. It doesn't occur to them that other people can't automatically recognize the correct path.
--- On Mon, 8/25/08, Downing, David <DavidDowning -at- users -dot- com> wrote:
> From: Downing, David <DavidDowning -at- users -dot- com>
> Subject: Why didn't they ask US for help???
> To: techwr-l -at- lists -dot- techwr-l -dot- com
> Date: Monday, August 25, 2008, 11:20 AM
> Our email is in the process of being "migrated"
> from one email system to
> another, and we've been given instructions for what to
> do to get
> ourselves set up properly on the new system. But a number
> of people --
> myself included -- need to call upon someone to walk us
> through the
> procedure, because he instructions weren't written very
> well.
> Specifically, they didn't give us enough information.
> We were told to
> run a particular program and follow the instructions on the
> screen, but
> not what to ever at various prompts.
>
> Now the thing is, we have a documentation department here
> who knows how
> to write instructions. That's the department I work in.
> Since the system
> administrators knew we were here, why didn't they ask
> us for help
> writing the instructions. My manager says he wouldn't
> have wanted to get
> involved with that, and maybe I wouldn't have either,
> but I would have
> wanted to be wanted. It would have been nice if they'd
> at least thought
> of asking us, and I'm wondering why they didn't.
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> ComponentOne Doc-To-Help gives you everything you need to
> author and
> publish quality Help, Web, and print content. Perfect for
> technical
> authors, developers, and policy writers. Download a FREE
> trial.
>http://www.componentone.com/DocToHelp/
>
> 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
> klhra -at- yahoo -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/klhra%40yahoo.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.
ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial. http://www.componentone.com/DocToHelp/
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-