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: Walk-throughs From:George Mena <George -dot- Mena -at- ESSTECH -dot- COM> Date:Tue, 2 Jun 1998 11:06:56 -0700
A couple of things show up for me:
1) The "powers that be" at your place are out to lunch big time.
Anyone in a supervisory or managerial position who says he doesn't want
to sit down and review the manual for technical accuracy is looking to
re-enter the unemployment line and to make corporate profitability
suffer by letting unreviewed manuals go out the door with the products.
Find another job with a better company ASAP. Protect your professional
reputation.
2) At a minimum, you as the writer should have gone through at least
some of the procedures in the manual yourself with the product. Taking
the hands-on approach in checking what you wrote by actually performing
the procedures in the manual is a good way to make sure you in fact KNOW
what you're writing about. Have you sat down with the product and
actually performed the task yourself? It's very important you try to do
that as much as possible, as it adds to your proactive credibility as a
tech writer. You don't wait for someone to tell you the answer: you go
out and find the answer.
It would definitely help to know what the product being documented is
and in what kind of environment the product is used in.
George Mena
> -----Original Message-----
> From: Kate Skilton [SMTP:KNSkilt -at- ACCUSORT -dot- COM]
> Sent: Tuesday, June 02, 1998 6:49 AM
> To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
> Subject: Walk-throughs
>
> Hi all -
>
> I was wondering if anyone out there had ever conducted a manual
> walkthrough, either in the preliminary or final stages. I'm looking
> for a different approach to our walkthroughs. I work for a company
> where nobody wants to sit down and dedicate a few hours to the
> quality of our manuals.
>
> Ideas anyone?
>
> Kate Skilton
> Engineering Technical Writer
> Accu-Sort Systems, inc.
>
> &^~~~
> Send commands to listserv -at- listserv -dot- okstate -dot- edu (e.g., SIGNOFF
> TECHWR-L)
> Find TECHWR-L-related books at
>http://www.raycomm.com/techwhirl/books.htm
>
