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: "Al Geist" <al -at- geistarts -dot- com>
To: "'techwrl'" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 20 Dec 2013 15:53:00 -0500

Robert Lauriston said "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."

First....."tire" is not an acronym. Second, never assume that your reader
knows as much as you think they do.

Al Geist-Geist Arts
Fine Art Photography
Mobile: 231-301-5770
E-mail: al -at- geistarts -dot- com
Website: www.geistarts.com
Facebook: Geist Arts
See Also:
Technical Communication, Help, Documentation Management

"We can't solve problems by using the same kind of thinking we used to
create them." (Albert Einstein)




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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


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: 12 High-Paying Jobs For People Who Don't Like Math
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