Re: Clashing Initialisms

Subject: Re: Clashing Initialisms
From: "Peter Neilson" <neilson -at- windstream -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 18 Apr 2012 07:58:10 -0400

On 18.04.2012 08:41, Sion Lane wrote:

I have a document where CLI is the initialism of both Caller Line
Identification and Command Line Interface.

You need to use AI (Adaptive Initialism) to represent the AI (Alternate Identification) scheme in this AI (Abstrusified Implementation) of AI (Additional Idiocy).

Step back three paces, scream, step back three paces more, scream again, and then revise your whole approach.

If the product description or the product itself already uses both initialisms, then a warning paragraph, outlined in flashing bold squiggles, should direct the reader to methods for overcoming the confusion. "The two separate and seemingly confusing uses of CLI can readily be detected through context. Application of this technique is left as an exercise for the reader."

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.

Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.

http://bit.ly/doc-to-help

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

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
Clashing Initialisms: From: Sion Lane
Re: Clashing Initialisms: From: jimmy

Previous by Author: Re: Documentation Process in an Agile environment
Next by Author: Re: API - Suggestions on Document
Previous by Thread: Re: Clashing Initialisms
Next by Thread: Re: Clashing Initialisms


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


Sponsored Ads