TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Hi, I'm sorry but I didn't get Jennifer's email although I did receive an
email off-list from Steve Hudson. He suggested I use "obsolete" and "to be
phased out" instead. I have promptly followed his suggestion before anyone
else stops me in the corridor and asks "why did you use DEPRECATED?"
So, the final choice was one of convenience for all.
From: Jane Carnall [mailto:jane -dot- carnall -at- digitalbridges -dot- com]
Sent: 06 February 2002 1:10 pm
Subject: RE: Terminology
Richard Pineger Wrote:
>I have written an internal Procedure template for a tech writing house
>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
>really common usage.
Carey Jennifer (Cry) responded:
>To respond though: My understanding is that DEPRECATED is standard and
>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.
The writers all stand around a cauldron chanting and occasionally tossing in
a deprecated rodent.
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
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.