Amichai Rothman created JAMES-2699:
--------------------------------------
Summary: Deprecation without documentation
Key: JAMES-2699
URL: https://issues.apache.org/jira/browse/JAMES-2699
Project: James Server
Issue Type: Bug
Components: Matchers/Mailets (bundled)
Affects Versions: 3.4.0
Reporter: Amichai Rothman
In the current Mailet API there are many deprecated classes and methods marked
with the @Deprecated annotation and some also with the @deprecated javadoc tag.
However, very few of these have any related documentation on what to use
instead, or at least why it is deprecated if there is no alternative. As it is,
someone using or implementing the API has no idea what the migration path
should be to avoid using these deprecated APIs which may disappear in the
future.
Please document all deprecations, most importantly with what is the recommended
way to migrate away from them.
This may be true for other modules as well, but certainly is in this central
API.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
