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: Basic rules of technical writing From:"Robert E. Allen" <re_allen -at- PNL -dot- GOV> Date:Fri, 30 Dec 1994 15:37:47 GMT
A couple of basic rules I've come across:
1. Writers must rely more on the feel of a sentence than on the
dictates of a rule book. (James J. Kirkpatrick, The Writers Art)
2. It is more important to be nearly right and understandable than
to be academically accurate and unintelligible. (unattributed)
The first rule says that absolute adherance to the rules of grammer
is not the guiding directive of the universe. It also seems to accept
the evolution of the language.
The second rule was well illustrated by Richard Mateosian in his
post, "Technical Correctness."
I have been known to ignore some of the rules of grammer when they
interfered with communication. This is a rare thing since the rules
(or is "conventions" a better term) of grammer define the relationship
of the words in the sentence and give a mutually agreed on meaning
to the sentence. Most of my deviations from the high school grammer
book fall in the "style" category; I routinely ignore the dictate "A preposition
is a bad word to end a sentence with." ;-)