TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
The acronym thread reminded me of an incident that happened a few contracts ago:
Another writer and I were assigned to write separate documents and then swap them for editing - at which point we discovered that we had staggeringly different points of view over the spelling out of some acronyms.
She insisted that *all* acronyms had to be spelled out at first use, preferably first use each chapter. I insisted that some acronyms had reached the status of words within the computer world (PC, HTML, PCMCIA, IBM, ASCII, IP) and it would be more confusing to the reader by cluttering the document with constant reiterations of what they really meant.
I'd be curious on other comments on this. Even in a technical document for not-necessarily-technical end users, would you say:
"This mail program uses only ASCII text, meaning the standard characters on your keyboard."
or
"This mail program uses only American Standard Code for Information Interchange (ASCII) text, meaning the standard characters on your keyboard."
Nea Dodson
(who is so used to typing just "ASCII" that I had to go look up what it really means.)
*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com
TECH*COMM 2001 Conference, July 15-18 in Washington, DC
The Help Technology Conference, August 21-24 in Boston, MA
Details and online registration at http://www.SolutionsEvents.com
---
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 http://www.raycomm.com/techwhirl/ for more resources and info.