HAWLEY & ASSOCIATES



Writing Style

Guide



Copyright © 1999 Hawley & Associates.
All Rights Reserved.

Part Number: 0000-0001
Rev. Number: 1.0
Publication Date: February 1999



Hawley & Associates
37456 Fremont Blvd.
Fremont, CA 94538 (510)-625-5270




Table of Contents

Preface

How This Guide is Organized

Guide Conventions

1. ORGANIZATION OF MANUALS

1.1 Title Page

1.1.1 Title Page

1.1.2 Preface

1.1.3 Table of Contents

1.2 Body of Manual

1.2.1 Outline

1.2.2 Chapters

1.2.3 Figures, Tables and Lists

1.2.4 Examples, Notes and Warnings

1.3 Appendixes and Glossaries

1.3.1 Appendixes

1.3.2 Glossary

1.4 Index

1.4.1 Creating the Index

2. STYLE AND PUNCTUATION

2.1 Writing Style

2.1.1 Chapter Titles

2.1.2 Organizing Topics

2.2 Punctuation

2.2.1 Apostrophes

2.2.2 Brackets

2.2.3 Colons

2.2.4 Commas

2.2.5 Contractions

2.2.6 Dashes

2.2.7 Ellipsis Mark

2.2.8 Hyphens

2.2.9 Parentheses

2.2.10 Periods

2.2.11 Quotation marks

2.2.12 Semicolon

3. Abbreviations, Numbers and Additional Topics

3.1 Abbreviations, Acronyms & Units of Measurement

3.1.1 Abbreviations and Acronyms in Text

3.1.2 Abbreviations and Acronyms Punctuation

3.1.3 Units of Measurement

3.2 Numbers and numerals

3.2.1 Spelling out numbers

3.2.2 Using Numerals

3.2.3 Punctuating Numbers and Numerals

3.2.4 Using Fractions

3.2.5 Dates and Times

3.3 Capitalization

3.3.1 When to Capitalize

3.3.2 When Not to Capitalize

3.4 font Conventions

3.5 Miscellaneous Topics

3.5.1 Cliches

3.5.2 Euphemisms

3.5.3 Sexism in Writing

4. Choosing the Right Word

5. Company Information

5.1 Company Name and Address

5.2 Product Names and Trademarks

5.2.1 Trademarks

Appendix A: References


List of Figures and Tables

Example Figure

Example Table

Abbreviation Table

Misused Words Table

Trademarks Table


Preface

This guide describes proper writing style for documents written by Hawley & Associates. Good technical writing is often hard to identify because it usually goes unnoticed, while bad technical writing is easy to notice, whether it's spelling or grammatical errors, inaccurate or confusing technical language, colloquial or offensive language, or other problems. One way to avoid these pitfalls is to follow the rules found in a good writing style guide.

This guide is not the only definitive style guide in existence, and we recommend referring to other style guides, such as Elements of Style by Strunk and White and The Chicago Manual of Style in addition to this guide, for style questions.


<back to TOC>



How This Guide Is Organized

This guide contains the following chapters:

Chapter 1: Organization of Manual

Chapter 2: Style and Punctuation

Chapter 3: Abbreviations, Numbers and Miscellaneous Topics

Chapter 4: Choosing the Right Word

Chapter 5: Company Information

Appendix A: References


<back to TOC>



Guide Conventions

Main chapter topics or important concepts are displayed in bold text.

Examples or book titles are displayed in Arial font or italic text.

Computer messages are displayed in courier text.


<back to TOC>