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: In love with a word From:John Cook <john -dot- cook -at- gmail -dot- com> To:TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Thu, 5 Jan 2006 09:02:26 -0600
On 1/5/06, Al Geist <al -dot- geist -at- geistassociates -dot- com> wrote:
> That VP of Engineering I spoke of who used "utilized" when he should
> have used "use," and sprinkled "amongst" liberally throughout his Help
> text was, incidentally, also the head of the local school board.
Ah, and that raises another interesting point.
Good Technical Writing is about self control, knowing your audience,
preferring clarity over vanity, knowing what you'd /like/ to write and
knowing what you /should/ write, and choosing the better option
despite personal preference.
In short, it appears that your VP was too proud to write right and too
vain to learn better.
Sometimes, it's better to be humble (or, better yet, to be confident
enough in your own prowess to humble yourself on behalf of your end
user).
Confession: I did write, at one point, something to our Field Service
techs for them not to do something, ending the instruction with this
line: "That would be bad."
I'd never do that in end-user documentation, but it seemed to fit our
rather more in-house procedures. Apparently, I wasn't quite humble
enough myself on that day, but it still makes me smile when I think of
it. ; )
--
John Cook
Technical Writer / Help Author
john dot cook at gmail dot com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author
content and configure Help in MS Word or any HTML editor. No
proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-