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: New slant: professionalism From:Damien Braniff <Damien_Braniff -at- PAC -dot- CO -dot- UK> Date:Mon, 27 Apr 1998 09:09:17 +0100
Re MIL Standards. I too have spent several (!) years writing for the
military (in the UK) and while some of the spec were indeed quite stringent
there were others you could drive a bus through - sideways! This was
mainly down to how the spec could be interpreted. In the end what we did
was, for each job, produced a "model chapter" basd on the spec and got that
approved. In effect we specified the interpretation of the spec so that
any ambiguity was removed.
A lot of the "bad writing" comes, in part, due to documentation HAVING to
be provided as part of the contract and, as long as it was there, it
didn't matter wod did it or what it looked like. Thankfully that is
(has??) changing in most places. Recently, however, I did a brief survey of
local companies about what they thought of documentation - what they used,
who wrote it, how important it was (1=V important, 9=had to have some). On
the whole the replies rated the importance in the region 1-3 but there were
still a couple of 9s in there.