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:Style guides, take II From:"Geoff Hart (by way of \"Eric J. Ray\" <ejray -at- raycomm -dot- com>)" <ght -at- MTL -dot- FERIC -dot- CA> Date:Sat, 12 Dec 1998 04:54:29 -0700
In the spirit of synchronicity, Don Bush (one of my favorite writers
on the topic of editing) had a few choice comments on the second
edition of the Microsoft style guide (The grammar of "Microspeak",
_Intercom_, Dec. 98, pages 36-37). Although he did not completely
dismiss the utility of this guide, he did have some rather pointed
comments that cast its merits into doubt, at least for me. I quote
(typos mine):
"Even more ominously, the the book distorts the very nature of
editing, changing it from a vocation of making authors accessible to
a low-skilled chore of zapping taboos."
"Why would anyone promoting 'consistency' publish a style guide
that does not agree with recognized authorities?" [Bush lists 8 of
these authorities, all of whose opinions I respect.]
"Ironically, excessive taboos can make technical writing worse.
While language cops are busy policing inconsequential violations,
they inevitably overlook major crimes against technical accuracy,
organisation, structure, and conciseness. The proof lies in the
Microsoft manual itself, which is stilted, wordy, disorganized,
ambiguous, and repetitious, and even violates its own rules."
Humph. I've always thought that "Microsoft style" was an oxymoron.
Here's some more evidence.
--Geoff Hart @8^{)}
geoff-h -at- mtl -dot- feric -dot- ca