Re: Style Manual

Subject: Re: Style Manual
From: jkajpust -at- concentric -dot- net
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 27 Mar 2001 22:41:35 -0500

I've been updating our company's version of a writing manual. What
I use most in it are things like correct terminology, e-mail/email, or
FAQ/faq, that sort of thing. Preferred spellings, cancelled/canceled.
I put in a section of our trademarks along with commonly used
marks of products we use (SM service marks, TM trademarks, R
registered, etc.). I also added a chapter about trademark use from
our legal dept.

I also added some technical abbreviations, nm, Kb, bps, etc. There
are also examples of customer facing e-mail and letter formats.

Because most other writers in our group aren't very experienced, I
also added some typographic stuff; curly/straight quotes, keyboard
equivalents for Word and FrameMaker.

As strange as it might seem, what I make most use of is the list of
words. I have problems remembering stuff like is it dropdown or
drop down.

In the long run, what I tried to do (and I haven't written it, just revised
an existing one) was to have examples of things that can be done in
more than one way -- be done in one way only for continuity. I don't
really care whether it's cancelled or canceled, as long as it is always
one or the other.

From: "Arthur Schweke" <tekritelist -at- hotmail -dot- com>

> I am designing a style manual for our department. It is not to be an
> elaborate document. Questions of grammar and styles, such as footnotes and
> cross references will be referred to the Chicago Manual of Style. Computer
> terms will be referred to the Microsoft Manual of Style for Technical
> How would you design this manual? What elements would you include?

Jim Kajpust - Personal Responsibility - Personal Freedoms
Michigan -


*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available 4/30/01 at or info -at- devahelp -dot- com

A landmark hotel, one of America's most beautiful cities, and
three and a half days of immersion in the state of the art:
IPCC 01, Oct. 24-27 in Santa Fe.

You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: Re: New TECHWR-L Poll Question
Next by Author: Re: Open Source Project Management Tool
Previous by Thread: Re: Style Manual
Next by Thread: Re: Style Manual

What this post helpful? Share it with friends and colleagues:

Sponsored Ads