Re: "aka" - commonly understood ?

Subject: Re: "aka" - commonly understood ?
From: Tony Chung <tonyc -at- tonychung -dot- ca>
To: TechWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 13 Jul 2011 14:24:19 -0700

I think saying "aka" without the periods to signify it's an acronym may
cause more confusion, a.k.a. people may not understand.

However, in your glossary, I think you are right to avoid it. The idea would
that one term could also be called something else could cause enough
confusion already. What ever happened to controlled vocabulary? (rhetorical
question).

So my gut tells me to provide definition for the correct term, and add
entries for the alternate terms that say "see term1". If a number of terms
are related, "see also..." and "related: " work well.

I think.

-Tony


On Wed, Jul 13, 2011 at 12:54 PM, Monique Semp
<monique -dot- semp -at- earthlink -dot- net>wrote:

> In a table of terms and definitions that I inherited, alternate terms are
> explained as “aka <alternate-terms>”. Any thoughts on whether people will
> understand this?
>
> (And I’m deliberately not saying what “aka” is so that I get a less biased
> response :-).
>
> Thanks,
> -Monique
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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://www.doctohelp.com

---
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-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


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

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

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
"aka" - commonly understood ?: From: Monique Semp

Previous by Author: Re: HTML Query
Next by Author: Re: Modern vs Old-fashioned Help
Previous by Thread: Re: "aka" - commonly understood ?
Next by Thread: RE: "aka" - commonly understood ?


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

Sponsored Ads


Sponsored Ads