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: Dan Goldstein <DGoldstein -at- cytomedix -dot- com>
To: "TECHWR-L (techwr-l -at- lists -dot- techwr-l -dot- com)" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 20 Dec 2013 16:03:52 -0500

The document was written by engineers for sys admins, i.e. the writers already know that the readers know the acronyms. Someone wants 'em there anyway.

The OP is new at the gig, and should defer to the engineers' judgment in this regard. No harm, no foul.


-----Original Message-----
From: Robert Lauriston
Sent: Friday, December 20, 2013 11:45 AM
To: Elissa K. Miller; techwrl
Subject: Re: On the value of glossaries containing terms the audience should already know

I think it would be weird to define RFC, SSH, LDAP, DNS, or IP in a document aimed at network administrators or the like. That would be like defining "tire" in a car manual.

If somebody wonders what USB stands for they can Google it.




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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
Re: On the value of glossaries containing terms the audience should already know: From: Robert Lauriston

Previous by Author: RE: On the value of glossaries containing terms the audience should already know
Next by Author: RE: Creative Labeling
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