Acronyms--How often do you spell them out?

[Poshedly, Ken]

The method described by Gene Kim-Eng is really the correct way to go.

Our job as tech writers is to make it easy for our "customer". Cutting
corners invites problems, including liability issues, too.

Put yourself in the place of the reader who gets the document minus the
section which contains first usage and definitions of terms, etc. Big
problem, eh?

Up until some time ago, this also the way news copy was written, but
unfortunately (in my opinion) it has changed. I started off with a
degree in news journalism, worked as a newspaper reporter, then a public
information officer for a major nonprofit organization and then
publications editor for several employers over the years before jumping
into technical writing fulltime in the early 1980s.

I still use some of my news writing techniques as tech writer, and it
really pays off.

Bottom line, define unfamiliar terms at first usage in each section that
MAY be removed.

-- Ken Poshedly
Atlanta, Georgia




 

-----Original Message-----
From: techwr-l-bounces+poshedlyk=polysius.com at lists.techwr-l.com
[mailto:techwr-l-bounces+poshedlyk=polysius.com at lists.techwr-l.com] On
Behalf Of Darges, Katherine
Sent: Monday, July 31, 2006 3:23 PM
To: techwr-l at lists.techwr-l.com
Subject: Acronyms--How often do you spell them out?

All,

 

I am editing a multi-section document, with each section 50 to 75 pages.
The document was written by the Government for the Government.  Phrases
that get turned into acronyms are spelled out when they are first used,
followed by their acronyms in parentheses - most in the first section.
Appendix A is a complete acronym list - about 300 all together (this IS
the Government, after all).  

 

Would you re-identify the acronyms in each subsequent section as well as
adding the new ones?  Or, is once really enough, based on the fact that
the readers of the document have all been involved in the project of
which the document is a record?

 

Thanks!

 

V/r (that's "Very respectfully" in Government shorthand),

 

Katherine

 

Katherine Darges

Sr. Management Analyst

National Security Programs Group

 

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l 

Doc-To-Help includes a one-click RoboHelp project converter. It's that
easy.  Watch the demo at http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as poshedlyK at polysius.com.

To unsubscribe send a blank email to
techwr-l-unsubscribe at lists.techwr-l.com
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/poshedlyk%40polysius.
com


To subscribe, send a blank email to techwr-l-join at lists.techwr-l.com

Send administrative questions to lisa at techwr-l.com. Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.

__________________________

This e-mail message and any attachment contains private
and confidential information and is intended for the addressee only.  If you are not the intended recipient (or responsible
for delivery of the message to such person), please do not read, copy, use or disclose this communication to others.
If you have received this message in error, please notify the sender by replying to this message, and then delete it from your system.  Thank you.
____________________ 
Polysius Corp.  
Atlanta, Ga.   USA
http://www.PolysiusUSA.com
Voice:    770-955-3660
Main Fax: 770-955-8789