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.
>How accurate is this book? Should I take what the book says with a grain
>of salt? Does this book reflect the industry's standard? Or are these
>technical writing "rules" one company's opnion?
There are many things about writing style that are a matter of opinion,
and in which the only firm rule is that it's best to be consistent in
whatever way you choose to go. The MicrosoftManual of Style was adapted
from the MS in-house sytle guide and in many instances reflects the way
they have decided to go on issues.
It's a good idea when you're just starting out to have access to two or
three style guides. That will give you a better idea which rules are
hard and fast (all of your sources agree) and which are judgement calls
in which the critical thing is to be consistent. (Your sources disagree.)
>For example, I have been told to write "click on the button" but according to
> the Manual of Style book, the correct way is to write "click the button."
Just for the record, Microsoft style guidelines aside, I prefer the way
you've been taught. ;) It seems to be there is an implied mouse in the
construction. That is, "Click (the left mouse button) on the OK button."
Technical Communication mta -at- cyberspace -dot- org (h)
& Help System Design mtucker2 -at- e-mail -dot- com (w)