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: Any comments on these 2 books? From:Lisa Higgins <lisa -at- DRDDO1 -dot- EI -dot- LUCENT -dot- COM> Date:Mon, 14 Apr 1997 11:01:04 +0000
> Ajig Alcalde wrote:
> >> Has anyone read the following two books?
> >> Can you give me your opinions about them?
> >> Lyn Dupre, "BUGS in Writing" Addison Wesley
> >> Microsoft Manual of Style for Technical Documentation.
> I'm not familiar with "BUGS in Writing", but I do recommend the Microsoft
> Manual Of Style. It's a good reference to use if you're not sure of which
> terms to use to refer to certain hardware/software items (e.g., "What
> should I use as the plural of 'mouse'?", "Does 'double-click' always need
> the hyphen?", etc.
I've never actually used the MS Manual of Style on the job, but that
is by design. I was given it to look over and make recommendations
on, and I found it absolutely appalling, and I very strongly
recommend against using it.
Its publication followed fairly closely Bill Gates' statement that
Microsoft was "not in the documentation business."
And it shows. The manual seems to have been written primarily for the
purpose of protecting their trademark of the term "Windows."
The manual regularly recommends that single words be replaced with
bizarre compound nouns and complex adjectival strings, and frankly,
it doesn't really answer a lot of questions you'll probably have. I'd
venture to say that a great deal of the success of third party
documentation rests with corporate standards such as those now being
made public in the MS Manual of Style. If I had a little more time
today, I'd hone the edges on this conspiracy theory, but I don't, so
(BTW, isn't their solution to the plural of 'mouse' to call it a
'mouse pointing device' or something equally ridiculous?)