Re: On the value of glossaries containing terms the audience should already know

Subject: Re: On the value of glossaries containing terms the audience should already know
From: Gene Kim-Eng <techwr -at- genek -dot- com>
To: "Elissa K. Miller" <emiller -at- doubleknot -dot- com>, techwrl <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 19 Dec 2013 13:05:17 -0800

There's ALWAYS going to be somebody looking at a manual who doesn't have the technical chops to understand every acronym in it. Leaving out the definitions will almost certainly increase the odds that that somebody will be the person whose signature is needed on a contract or PO to buy the product.

Gene Kim-Eng


On 12/19/2013 8:44 AM, Elissa K. Miller wrote:


But, the industry terms in the glossary are bugging me-they're defining
really basic terms like RFC, SSH, LDAP, DNS, and IP, and I don't think you
have any business mucking around with *anything* covered in this guide if
you don't know what DNS and IP mean.



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

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

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


Follow-Ups:

References:
On the value of glossaries containing terms the audience should already know: From: Elissa K. Miller

Previous by Author: Re: Creative Labeling
Next by Author: Re: [BULK] Re: On the value of glossaries containing terms the audience should already know
Previous by Thread: Re: On the value of glossaries containing terms the audience should already know
Next by Thread: RE: On the value of glossaries containing terms the audience should already know


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

Sponsored Ads


Sponsored Ads