Re: Clashing Initialisms
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.
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
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
Search our Technical Writing Archives & Magazine