Technical Writing with Style

A publication that features ideas for writing step-by-step procedures and troubleshooting support documentation for electronic, Internet, and print distribution--and much more!

Table of Contents

 

Abbreviations and Acronyms

Abbreviations are the shortened form of a word or phrase; such as U.S. for United States, sec. for secretary, adj. for adjective, C.P. for Command Post, and so on. Most professions and all governmental entities have their own lists of "approved" abbreviations for use when space is limited as in notes, tables and lists. The assumption is that everyone reading a document with abbreviations knows their meaning.

Abbreviations usually exclude vowels after the first or second letter and include a letter or two to represent each syllable in the word. But there are many exceptions; for example, abbreviation (ab-bre-vi-a-tion) is usually shortened to: abbrev.

To identify them as abbreviations, most writers will insert a period after the abbreviation of a word and after each letter that represents words in a phrase. But again, there are many exceptions; for example, the United States can be abbreviated as U.S or US.

A capitalized letter is often used to represent each word in a phrase, the only exceptions being the articles: and, of, on, the. For example, the radio broadcast station Voice of America's name is abbreviated as either V.O.A. or VOA. It is in the abbreviation of phrases that abbreviations resemble acronyms.

It is always acceptable to mix full words and abbreviations in tables, lists and package labels. Just because you used an abbreviation for one word, there is no reason to use it again if there is sufficient space for the full word elsewhere. Abbreviations must be consistent in the same document, never use a different spelling for an abbreviation in the same document.

Originally intended to facilitate the shorthand transcription of conversations onto paper, when an abbreviation becomes commonly used in conversations, it may be considered as an acronym.

(Consider: Internet abbreviations and capitalizing abbreviations.)

Acronyms are words formed from the first or first few letters in a series of words; for example, codec was derived from compression/decompression and radar from radio detecting and ranging. Although most acronyms are capitalized, periods are not used to separate letters representing individual words; use DOS for Disk Operating System, not D.O.S. (Consider: capitalizing Acronyms .)

 

"Abbreviations and Acronyms" and other concepts are thoroughly explored in the book: Technical Writing with Style.


Abbreviations and Acronyms with Numbers

When abbreviations and numbers are used together, most authors do not insert a space between them because together they are an adjective used to describe a product.

 

Measurement reference scale

  • Zetta ( Z ) = 1021 Sextillion
  • Exa ( E ) = 1018 Quintillion
  • Peta ( P ) = 1015 Quadrillion
  • Tera ( T ) = 1012 Trillion
  • Giga ( G ) = 1,000,000,000.00 Billion
  • Mega ( M ) = 1,000,000.0 Millions
  • Kilo ( K ) = 1,000.0 Thousands
  • Hecto ( h ) = 100.0 Hundredfold
  • Deka ( da ) = 1,0.0 Tenfold
  • Deci ( d ) = 0.1 Tenth
  • Centi ( c ) = 0.01 Hundredth
  • Milli ( m ) = 0.001 Thousandth
  • Micro ( ) = 0.000001 Millionth
  • Nano ( n ) = 0.000000001 Billionth
  • Pico ( p ) = 10-12 Trillionth
  • Femto ( f ) = 10-15 Quadrillionth
  • Atto ( a ) = 10-18 Quintillionth

Units of Measure abbreviations

  • - dimensionless MHO 1/ohms
  • % percentage ohm
  • dB decibels V Volts
  • dBM decibel milliwatt W Watts
  • dBV decibel Volts H Henrys
  • decade decade WB Webers
  • octave octave N Newtons
  • ppm parts per million J Joules
  • # events POISE Poise
  • m meters g grams
  • K degree Kelvin 1/s 1/second
  • ° degree PAL Pascal
  • A amps L liter
  • Hz Hertz T Telsa
  • s secon DIV Divisionds
  • C Coulombs F Farads

Mathematical operators

  • ^ power + addition
  • - subtraction * multiplication
  • / division mod modulus
  • and logical bitwise AND or logical bitwise OR
  • xor logical bitwise exclusive OR | string concatenation
  • || string concatenation != not equal to
  • less than = less than or equal
  • = equal greater than
  • = greater than or equal ~!= approximately not equal to
  • ~ approximately less than
  • ~ = approximately less than or equal
  • ~= approximately equal
  • ~ approximately greater than
  • ~ = approximately greater than or equal

 

Examples:

  • 150Kbps reads as 150 Kilobits-per-second (transfer rate)
  • 3MBps reads as 3 MegaBytes per second
  • 45MHz reads as 45 MegaHertzs
  • 45mph reads as 45 miles per hour
  • 1V reads as 1 micro volt
  • 1mV reads as 1000 milli-volts
  • 1KV reads as 1000 volts
  • 1M reads as 1 mega-ohms

 

Comments:

The word "bits" is represented by a lowercase "b." The word "bytes" is represented by a uppercase "B." Consider: capitalizing Abbreviations and Acronyms .)

"Abbreviations and Acronyms with Numbers" and other concepts are thoroughly explored in the book: Technical Writing with Style.

Using an Acronym Without Definition

Typically, when acronyms are printed, either the acronym or the words it represents are placed in parenthesis. The definition of an acronym need not be included:

a. For relatively old concepts with definitions that are generally known ("i.e.");

b. When spoken, the acronym sounds like no other word; and

c. When the reader is assumed to have some familiarity with the topic which should include the acronym.

Examples:

  • DOS. What version of DOS is installed?
  • OS. What OS does the system use?
  • System OS: DOS, Win 3.1, Win95, Win9.x, WinNT, MacOS, UNIX (please circle).
  • LAN. How extensive is their LAN?
  • DB. How do I merge my DB data with my WP document?
  • DTP or WP, which do you use for your newsletter?
  • IO. System IO options include (At some point "IO" will be generally considered as interchangeable with "input/output," and "in/out" for nontechnical communications.)
  • INI (or "dot-INI"). The installation changed my INI file.
  • What is on the desktop?

"Using Acronyms Without Definition" and other concepts are thoroughly explored in the book: Technical Writing with Style.


Evolving Acronyms

Variations of Acronyms should start with the core technology followed by a hyphen and then subset concept. This will differentiate the device or process from those it may have derived from; as well as, those that derived from it.

Examples:

  • CD. Compact Disk with a recording on a single side
  • CD-E. Erasable CD drive
  • CD-I. CD interactive drive
  • CD-P. Compatible with Kodak Photo CD standard
  • CD, CD-ROM. Single-speed CD drive with a potential 150 KeloBytes-per-second (KBps) data transfer rate, but realistically about 90KBps
  • CD-2X. Double-speed CD drive with a potential data transfer rate of 300KBps, but realistically between 150 to 200KBps
  • CD-4X. Quad-speed CD drive with a potential transfer rate of 600KBps, but realistically between 300 to 450KBps
  • CD-6X. Six-speed CD drive with a potential transfer rate of 900KBps, but realistically between 450 to 600KBps
  • CD-8X. Eight-speed CD drive with a realistic data transfer rate between 300 to 450KBps
  • CD-10X. Ten-speed CD drive with a 3MBps (3 MegaBytes per second) transfer rate
  • CD-12X. Twelve-speed CD drive
  • CD-24X. Twenty-four-speed CD drive
  • CD-R. CD recorder which provides at least one of these formats: ISO 9660 (DOS/Windows and MacOS), HFS and HFS+ (MacOS), UDF (the ISO 13346 universal data format), CD audio (with data), CD-I, CD-P, and WORM
  • CD-V. Compatible with Video CD standard
  • CD-XA. CD-ROM with extended architecture combining CD data with interleaved compressed audio or video
  • HTTP. Hypertext Transport Protocol
  • HTTP/S. Secure Hypertext Transport Protocol

 

Comments:

DHTML is an incorrect construction of a new word for "Dynamic HTML." When constructing variations for acronyms, the abbreviation should start with the core technology acronym, followed by a hyphen and then subset concept.

HTML-D is an acceptable construction. In a glossary or dictionary, it would follow HTML. Why should a reader have to page between the "H" section of a dictionary and the "D" section.

Imagine yourself writing a glossary and you need to include references to various compact disk devices. Would it not be better to find these words listed together?:

  • CD, Compact Disk with a recording on a single side
  • CD-E, Erasable CD drive
  • CD-I, CD interactive drive

Yes I know "Dynamic HTML" reads well, but the Internet is international; many of its users speak English as a second language and often it is the "British English" dialect. For people whose primary language is other than English, "HTML Dynamic" may be easier to understand.

Glossaries and dictionaries are self-educational tools. If you are typical, when you lookup a specific word, you will also read definitions of one or more other words printed on the same or opposite page. These suggestions can help you to differentiate the device or process from those it may have derived from; as well as, those that derived from it.

"Evolving Acronyms" and other concepts are thoroughly explored in the book: Technical Writing with Style.

 


Internet abbreviations

These abbreviations are primarily intended for email communications. The assumption is that those who see read them will understand their meaning rather than interpreting the abbreviations as spelling or typographical errors.

Examples of abbreviated phrases:

  • aamof, as a matter of fact
  • bbfn, bye bye for now
  • btw, by the way
  • cmiiw, correct me if i'm wrong
  • fyi, for your information
  • iac, in any case
  • imho, in my humble opinion
  • otoh, on the other hand
  • lol, laugh out loud
  • tia, thanks in advance
  • tic, tongue in cheek
  • tyvm, thank you very much

Email communications has developed its own set of common abbreviations. Common facial expressions; also known as emoticons and "smileys," are substitutes for face-to-face communications that are used in email communications. The use of smileys assumes that readers will understand their meaning.

Examples:

:-) for smile :-\ for undecided ;-) for wink

:- for tongue tied :-} for grin :-@ for screaming

:-( for frown :-o for surprised :-| for indifferent

:-D for laughing for devilish for mad

:'-( for crying :-* for kiss {} for hug

"Internet Abbreviations" and other concepts are thoroughly explored in the book: Technical Writing with Style.


Compound Abbreviations in Tables and Lists

Space constraints, as often occurs in tables and lists of detailed technical information, may require the use of more than one acronym or abbreviation to describe a single product or process. Because they are printed and cannot be spoken without translation, they are considered compound abbreviations.

For Compound Abbreviations, hyphenate only the first one and then only if the hyphen connects it to a word (or acronym) naming the product or process. Subsequent adjectives (descriptions) are separated by commas. To fit more abbreviations into the table or list, it is acceptable to remove spaces between the comma and the abbreviation that follows it. No "and" is required.

Within the table or list, the Compound Abbreviation should be read as if it is a single-sentence paragraph. The assumption is that the reader will be able to interpret the letter combinations and thereby understand what you are trying to communicate. Definitions for the individual letter combinations should always be included on the same or opposite page, along with any footnote definitions of asterisk, superscript or subscript references.

Compound Abbreviations may also be used in product packaging. For this application, always consider the reader. A blizzard of letters and numbers can be confusing even to a salesperson. Whenever space permits, use the full word rather than its abbreviation.

Examples:

  • Statement: CD recorder drive, records CDs at 4-speed; plays CDs at 8-speed.
  • Abbreviated: CD-R,4Xr,8Xp
  • Alternative: CD-R4Xr8Xp

Bullets ( ) require a little more space than commas and are excellent substitutes. When set in a color to complement the text, they can be quite attractive. Consider using other dingbat-like characters ( A, , h, e, E, ) to complement the theme of the table or list, provided they are small, unobtrusive and dissimilar to standard keyboard characters and symbols.

  • Statement: CD recorder drive, records CDs at 4-speed; plays CDs at 8-speed.
  • Abbreviated: CD-R / 4Xr / 8Xp
  • Poor Alternative: CD-R/4Xr/8Xp

Use slashes rather than commas to divide statements where there is sufficient space before and after them. Without the additional space, slashes make reading the abbreviated statement more difficult because of their size, proximity to the other characters, and because readers may interpret them as abbreviational symbols for the words: by, times, with, part, and so on.

"Compound Abbreviations in Tables and Lists" and other concepts are thoroughly explored in the book: Technical Writing with Style.


Pronouncing Abbreviations and Acronyms

For abbreviations, pronounce the full word or words.

For acronyms, either spell the word or state its derivation. Avoid using substitute words in speech that do not include the acronym in their implied spelling.

Examples of Acronyms in speech:

  • For RAID, spell it out, or just say: "raid." Few people would understand what you were talking about if you, instead say: "Redundant Array of Independent Drives."
  • SCSI, is commonly pronounced as: "scuzzy." Unfortunately, few people spell this acronym. ("The computer store does not sell scuzzy cables; but they do have SCSI cables for sale.")
  • For GUI, most people say "Graphical User Interface" or just spell it out: "G U I." People who want to sound knowledgeable to people who know nothing say: "gooie." A salesperson would ask: "How do you spell that?" After attempting to look it up, he or she will tell you that it is not in the product catalog. (You want gooie? go to a supermarket.)
  • 1st, 2nd, 3rd, etc., are acronyms pronounced as "first, second, third" and so unjust like the numbers 1, 2, 3, etc., are pronounced as "one, two, three" and so on. They are not abbreviations. Do not place a period after these words unless they either occur at the end of a sentence or introduce items in a list.

Comments:

I know people who are afraid of computers, even though they use them every day for limited repetitive tasks, like billing, writing letters, or updating mailing lists. The words we learn and use each day and the concepts they represent may be the source of much of their fear. They may simply express their fear as: "give me a computer where I don't have to type anything; that all I have to do is tell the computer what I want to do, and it will do it."

"Pronouncing Abbreviations and Acronyms" and other concepts are thoroughly explored in the book: Technical Writing with Style.


LINKS

Introduction for Site and Samples

Table of Contents Technical Writing with Style ( First Edition )

Samples from the Getting the Words Right section in the book

Samples from the Punctuation section in the book

Samples of Software File Formats and process descriptions from the Technical Research Assistant 2000

Samples of Compendium of Hardware and Communications Concepts from the Technical Research Assistant 2000

Your EMAIL comments and purchase requests are invited

Now Shipping an expanded
Technical Writing with Style
- SECOND EDITION -
For 2000

Book Pricing

Copyright 2000 Ken Lachnicht, reprinted with permission by
CHAMPIONS Management Support Services, Inc. All rights reserved.

Visit our

Enter the library through its Opening page

Return to top