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: PREFERENCE: Style From:Kris Olberg <kjolberg -at- IX -dot- NETCOM -dot- COM> Date:Fri, 14 Nov 1997 13:03:24 -0600
-----Original Message-----
From: John L Patterson <a342jpatters -at- ATTMAIL -dot- COM>
To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU <TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU>
Date: Friday, November 14, 1997 11:41 AM
Subject: PREFERENCE: Style
>We are developing an in-house style guide for regulatory manuals. From
>your experience, please help us resolve the following issues:
When you change a tire on a car, you use a tire iron ... to hang a shelf on
the wall, you use a large screwdriver ... to replace a bow on eyeglasses,
you use a very small screwdriver ... to manipulate something in a tight
spot, you use a needlenose pliers ...
The first question to ask is this: What problem are you trying to solve?
I'd like to help, but I know nothing about your audience. A needs analysis
will tell you what info you need in headers, footers, etc.
IMHO, this is a huge problem facing technical writers today. SOME DON'T KNOW
WHAT PROBLEM THEY ARE SOLVING. We really need to learn how to identify
requirements FIRST and then identify the tools to solve the problem.
Regards...Kris
------------------------------
kolberg -at- actamed -dot- com
kris -at- olberg -dot- com
