RE: Terminology

Subject: RE: Terminology
From: "Jane Carnall" <jane -dot- carnall -at- digitalbridges -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 6 Feb 2002 12:10:09 -0000

Richard Pineger Wrote:
>I have written an internal Procedure template for a tech writing house
using
>the word DEPRECATED to describe a style that is no longer to be used.
>Some of the authors here did not know the word and feel that the word is
not
>really common usage.

Carey Jennifer (Cry) responded:
>To respond though: My understanding is that DEPRECATED is standard and
valid
>terminology in the programming world. HOWEVER, personally, as a Techwriter
>who is closer to the User end of documentation, in all of my 8 years of
>writing technical documentation, I had never encountered it before that
>thread, nor have I had cause to use it. So, standard and correct - yes.
>Known by all - No.
>Summary: you'll have to decide based on what you know of your audience and
>what they know.

True, but given that deprecated is the term in common use among programmers
(with an obvious inheritance from the original meaning among accountants,
which is by no means the case with all hacker jargon - why cookies, for
example?) isn't it part of our function as techwhirlers to instruct?

I'm fighting a campaign in the Javadoc I'm editing (which I will win <g>
because I get to be final editor, and besides the manager agrees with me) to
have programmers use sentences rather than the one word "deprecated":
"This --- has been deprecated and will be removed in a future release".
"This --- has been deprecated: use the replacement $%&! instead."

Even if the reader happens not to know what "deprecated" means, this gives
them the information they actually need to know, and hopefully next time
they run into it as a single word they'll remember the context and
understand what deprecated means.

HTH, FWIW.

Jane Carnall
The writers all stand around a cauldron chanting and occasionally tossing in
a deprecated rodent.


________________________________________________________________________

E-mail is an informal method of communication and may be subject to data corruption, interception and unauthorised amendment for which Digital Bridges Ltd will accept no liability. Therefore, it will normally be inappropriate to rely on information contained on e-mail without obtaining written confirmation.

This e-mail may contain confidential and/or privileged information. If you are not the intended recipient (or have received this e-mail in error) please notify the sender immediately and destroy this e-mail. Any unauthorized copying, disclosure or distribution of the material in this e-mail is strictly forbidden.

________________________________________________________________________


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Collect Royalties, Not Rejection Letters! Tell us your rejection story when you
submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of
your book. What are you waiting for? http://www.iuniverse.com/media/techwr

Have you looked at the new content on TECHWR-L lately?
See http://www.raycomm.com/techwhirl/ and check it out.

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


References:
RE: Terminology: From: Carey Jennifer (Cry)

Previous by Author: RE: What grade did *you* get in Geography?
Next by Author: Inventing verbs
Previous by Thread: RE: Terminology
Next by Thread: RE: Terminology


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

Sponsored Ads


Sponsored Ads