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.
Re: Does a Professional Tech Writer need to follow the Chicago Manual of Style?
Subject:Re: Does a Professional Tech Writer need to follow the Chicago Manual of Style? From:Janet_Swisher -at- TRILOGY -dot- COM Date:Fri, 20 Aug 1999 15:37:06 -0500
DHICKEY wrote:
>Should I be relying on one particular (published) style guide when
creating
>documents? Or is it more important to use your own rules consistently and
>wisely?
Being a Chicago graduate, I'm tempted to say "Of course you must use the
Chicago Manual of Style!" But in truth, I think it more important to use
your rules consistently. If you ever have to work on projects with more
than one writer, it helps to have them written down. At the company I
work for, our standard reference is the Microsoft Manual of Style (as with
most MS products, it's far from perfect, but it sets an industry
standard). This mainly addresses issues of software terminology and
usage, rather than the generic concerns of a style guide like the CMS. We
have a list of exceptions, bugaboos, and issues not covered in the MMS
(e.g., how this company treats trademarks), which is part of our internal
guide for writers (along with where to find stuff on the network, etc.).
Having a stated policy ensures consistency across writers on the issues
the organization cares about; when we use contractors, we state our style
policy as a condition of the contract.
Any issues not covered by our standard guides are left to the writer's
discretion. They can refer to some other style guide, or just their own
horse sense. I use the CMS when there's a question in my mind, but it's
possible I'm violating its dictates for things I never bothered to look
up.