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: Quality From:John Oriel <oriel -at- NTSC-RD -dot- NAVY -dot- MIL> Date:Thu, 11 Mar 1993 09:25:00 EST
Very good about user testing. My interest is in specifications
for items to be purchased by the Government. Our form of user-
testing is called the draft RFP. Draft RFPs help, but don't
completely solve the problem. Feedback is severely constrained
in the public contracting process because we need to ensure that
all offerors are provided with exactly the same information, and
that no one receives preferential treatment.
I've found that we _can_ catalog many types of errors that cause
confusion in specs. Ambiguous pronouns and incomplete references
are two especially interesting ones, because, a computer can flag
them automatically. (In specs, nearly every pronoun is
ambiguous.) There are many more in my catalog. I've found that
the overall quality of specs can be greatly enhanced by fixing
only those bugs that can be recognized easily. That's because
the specs are usually drafted by Government technical people
whose writing skills are rarely on a par with those of
I've written more, but decided to cut it off here and avoid
violating the one-screen rule. Thanks to all for your responses.