Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Eclipse/API Central/Deprecation Policy
< Eclipse | API Central
Revision as of 10:53, 23 October 2009 by John arthorne.ca.ibm.com (Talk | contribs)
This page contains draft Eclipse Project guidelines on API deprecation.
Contents
What is Deprecation?
Despite our best efforts, we don't always craft API that remains perfect forever. Often new and better approaches come along that supersede old ways of doing things. API deprecation is used to inform API clients that a particular API element is no longer recommended. The deprecation comment should describe the reason for the deprecation, and directions for how to replace their usage with the new recommended way of doing things.
Identifying Deprecated API
Java API
Extension Points
Retention of Deprecated API
References
Architecture Council/Meetings/API Deprecation 20080119 Java Deprecation Guidelines