Re: Deprecated (was When is it too much information?)

Subject: Re: Deprecated (was When is it too much information?)
From: Lauren <lauren -at- writeco -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 21 Feb 2013 10:21:46 -0800

On 2/21/2013 6:40 AM, Guy K. Haas wrote:

The term "deprecated" was used in American National Standards Institute programming language standards in the 1980s. Certainly the COBOL standard noted some deprecated features.

The term is perfect for documentation read by programmers, but users are not likely to understand it. I agree with everyone who has said that if it is deprecated, then do not discuss it in user documentation. Yehoshua (my apologies for using his last name and not first) mentioned a case where a feature is deprecated, in this case screen text, and the change may confuse users, so something should be noted in the change documentation. Users do not often know what "deprecated" means. User documentation should say what the feature or change means to the user in simple terms with language that the user, rather than the programmer, users.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
EPUB Webinar: Join STC Vice President Nicky Bleiel as she discusses tips for creating EPUB, the file format used for e-readers, tablets, smartphones, and more.

Learn more: http://bit.ly/12LyN2z

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

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


Follow-Ups:

References:
Deprecated (was When is it too much information?): From: Debbie Hemstreet
Re: Deprecated (was When is it too much information?): From: Lauren
Re: Deprecated (was When is it too much information?): From: Tony Chung
Re: Deprecated (was When is it too much information?): From: Peter Neilson
Re: Deprecated (was When is it too much information?): From: Peter Neilson

Previous by Author: Re: Deprecated (was When is it too much information?)
Next by Author: Re: Outlook, thunderbird, or...
Previous by Thread: Re: Deprecated (was When is it too much information?)
Next by Thread: RE: Deprecated (was When is it too much information?)


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

Sponsored Ads


Sponsored Ads