RE: Terminology question: Deprecated function

Subject: RE: Terminology question: Deprecated function
From: "Susan W. Gallagher" <SGallagher -at- akonix -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 10 Oct 2001 09:42:11 -0700

Don't change anything. "Deprecated" is the correct term; using
anything else would make your readers doubt your credibility.

Functions are deprecated but still supported because there is
a better function to take its place but a customer base that
has included it in code. The deprecated function lives on so
that the customer base does not have to rewrite its code, but
new development is encouraged to make use of the new function.

All you need say in your table is (deprecated)

Your audience will understand immediately. If you use another
term, this will not be the case.

-Sue Gallagher
sgallagher -at- akonix -dot- com

> -----Original Message-----
> From: Stern, Geoff [mailto:GStern -at- NetSilicon -dot- com]
> Our software engineers have been using the term "deprecated
> function" to
> mean a function that has been (and still is) fully supported but will
> not be supported in some future version (usually the next one or so).
> None of us -- engineers or writers -- likes this term,
> although it seems
> to be widespread usage in API documentation.
> Any suggestions for an alternative that's fairly laconic? (It would be
> nice to have something short enough to use in a kind of overview table
> or checklist of APIs.)

Announcing new options for IPCC 01, October 24-27 in Santa Fe.
Attend the entire event, select a single day, or sign up for
a Saturday postconference workshop.

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

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 for more resources and info.

Previous by Author: RE: Hobbies on a résumé (one blow to the dead horse)
Next by Author: RE: Voice and environment (was RE: Reading and Editing
Previous by Thread: RE: Terminology question: Deprecated function
Next by Thread: Re: Terminology question: Deprecated function

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

Sponsored Ads