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: style guide From:"Elizabeth Wilczek" <betsywilczek -at- hotmail -dot- com> To:techwr-l -at- lists -dot- raycomm -dot- com Date:Fri, 17 Dec 1999 08:47:49 EST
Sun's _Read Me First_ is a wonderful resource for writing about computers,
but your drug company co-workers will need some standards it doesn't
include--for example, the way to present chemical formulas or nicknames.
An intranet style guide can supplement huge written style books like the
Chicago Manual or AP Style Guide with short answers to questions that come
up again and again,
For example, give the rules for abbreviations (like B.A.) and acronyms (like
NATO). When do you spell out numbers and when do you use numerals? How do
these number rules apply to talking about dates, time of day, money? Post
some boilerplate language people can cut-and-paste to acknowledge
competitors' trademarks and (more important) protect your own. You might or
might not have some company standard about punctuation--serial commas,
em-dashes versus en-dashes.
Just my two cents worth--
Betsy Wilczek
New Jersey Society for Technical Communication
original message:
Subject: style guide
From: "Pam Hurley" <hurleyp -at- worldnet -dot- att -dot- net>
Date: Thu, 16 Dec 1999 14:28:31 -0500
I've been commissioned to produce an online style guide for a fledgling
drug company. Any suggestions in terms of other style guides I might peruse
to get a better idea of how to formulate this one--things covered, etc?
Thanks,
Pam Hurley
______________________________________________________
Get Your Private, Free Email at http://www.hotmail.com