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[2]: A user's commentary From:Don Smith <dsmith -at- ACCESSBEYOND -dot- COM> Date:Tue, 10 Dec 1996 07:50:06 EST
Rebecca -
Please tell your SME's that they are very wrong. Period.
(Of course MOO.)
Don
______________________________ Reply Separator _________________________________
Subject: Re: A user's commentary
Author: Rebecca Phillips <Rebecca -at- QRONUS -dot- CO -dot- IL> at INTERNET
Date: 12/9/96 3:49 PM
Thanks, Arlen, for the interesting (if depressing) user's commentary. I
find it helpful, particularly this part:
>----------
>2. Computer manuals do not have a Chapter 1. This is the chapter that
>tells you, in plain English, what the software does, how it works, and how
>to get started. This chapter has been removed from the Filemaker Pro
>manual, and something else was named Chapter 1.
My SMEs are always trying to take out the Chapter 1 part or put it as
the last chapter of the book. They say nobody needs all that background
junk. If they bought the product, they are supposed to know what to do
with it. They almost had me really thinking they could be right. After
reading this comment, though, I think I'll expand the chapter instead.
Rebecca
Rebecca M. Phillips
Documentation Manager
Qronus Interactive Ltd.
Automated System Testing http://www.qronus-int.com
rebecca -at- qronus -dot- co -dot- il
