style/usage question

Lauren lt34 at csus.edu
Thu Feb 1 20:43:50 MST 2007


Why would you say "(hereinafter referred to as 'Acrobat')" and not just
(Acrobat)?    I don't really understand the use of that introduction.  I
think that it is acceptable to use "Adobe Acrobat (Acrobat)" because the
convention is so common.  Just don't overuse it when readers probably
understand the short name.  I worked with an old-timer that wanted me to
introduce GUI as "Graphical User Interface (GUI)" for a document that was
written for programmers that were probably more familiar with the short name
than with the long name.

Lauren

-----Original Message-----
From: techwr-l-bounces+lt34=csus.edu at lists.techwr-l.com
[mailto:techwr-l-bounces+lt34=csus.edu at lists.techwr-l.com] On Behalf Of
Cardimon,Craig
Sent: Thursday, February 01, 2007 11:45 AM
To: Techwr-l
Subject: style/usage question

I guess this could also be a matter of style.

 

Image you are updating documentation that refers to "Adobe Acrobat" just as
"Acrobat," and the term is well known only within a certain industry.

 

Would it be fair to change the first occurrence of "Acrobat" to "Adobe
Acrobat," and then add something like "(hereinafter referred to as
'Acrobat')" ?

 

I will probably shorten the parenthetical expression up a bit, but that is
the first thing that popped into my head.

 

-- Craig

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

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team
authoring, Web-based technology, and PDF output.
http://www.DocToHelp.com/TechwrlList

Now shipping: Help & Manual 4 with RoboHelp(r) import! New editor, full
Unicode support. Create help files, web-based help and PDF in up to 106
languages with Help & Manual: http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as lt34 at csus.edu.

To unsubscribe send a blank email to
techwr-l-unsubscribe at lists.techwr-l.com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/lt34%40csus.edu


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

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




More information about the TECHWR-L mailing list