Re: Style Guide Help

Subject: Re: Style Guide Help
From: skwpt <skwpt -at- yahoo -dot- com>
To: chasity mcwilliams <chas -at- fcs -dot- uga -dot- edu>, TECHWR-L <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 28 Jun 2000 10:48:11 -0700 (PDT)


I recently wrote a style guide for my company. I
included topics such as style, company proprietary
information, abbreviations, capitalization, compound
words, constructing text, documenting sources,
grammar, numbers, punctuation, and an appendix that
included word choice, commonly misspelled words,
hyphenated words, and proofreader symbols and

As far determining your format and what should be
standard vs. personal preference... you'll need to
analyze your audience. Who's going to be reading this?
Are there any corporate conventions already in place
(use of logos, colors, company name, etc.) If not,
then you're pretty much in virgin territory here.

I used many resources to pull this together. (My
favorites were Brusaw, Sun, and Hackos). They

Brusaw, Charles T., Gerald J. Aldred and Walter E.
Oliu. Handbook of Technical Writing, Fifth Edition.
St. Martin?s Press, 1997.
Hackos, JoAnn T. and Dawn M. Stevens. Standards for
Online Communication. Wiley, 1997.
Hargis, Gretchen. Developing Quality Technical
Information: A Handbook for Writers and Editors.
Prentice Hall, 1998.
Pearsall, Thomas. The Elements of Technical Writing.
Allyn & Bacon, 1997.
Price, Jonathan and Henry Korman. How to Communicate
Technical Information. Addison-Wesley, 1993.
Strunk, William Jr., and E.B. White. The Elements of
Style. MacMillan, 1979.
Sun Technical Publications. Read Me First: A Style
Guide for the Computer Industry. SunSoft Press,
The America Heritage Dictionary of the English
Language, Third Edition. Houghton Mifflin, 1992.
The Chicago Manual of Style, 14th ed. U Chicago
Press, 1993.
Urdang, Laurence. The Dictionary of Confusable Words.
Ballantine, 1989.
Williams, Joseph M. Style: Ten Lessons in Claity and
Grace. Addison-Wesley Longman, 1997.
Woolever, Kristin R. and Helen M. Loeb. Writing for
the Computer Industry. Prentice Hall, 1994.

You say you're not a "trained" tech writer (or did I
assume incorrectly). Some of these online resources
may be helpful to you:

Technical Writer Glossary

The Elements of a Style Guide (Sun's as an example)

Yale Style Guide

How to write ""

Dictionary of plain language

Technical communication-related books

Guide to Grammar and Writing

List of Grammar Lists

Proofreading Symbols and Abbreviataions

I hope this helps

--- chasity mcwilliams <chas -at- fcs -dot- uga -dot- edu> wrote:
> I have been asked to create a style guide for our
> department.

Do You Yahoo!?
Get Yahoo! Mail - Free email you can access from anywhere!

Previous by Author: Re: Interviewing a technical writer -- LIST OF QUESTIONS
Next by Author: Re: Interviewing a technical writer -- questions?
Previous by Thread: Re: Style Guide Help
Next by Thread: RE: Style Guide Help

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

Sponsored Ads