[
https://issues.apache.org/jira/browse/JAMES-2699?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16807001#comment-16807001
]
Amichai Rothman commented on JAMES-2699:
----------------------------------------
Thanks, although it looks like the PR that was merged doesn't include any of
the javadocs this issue was about... maybe leave the issue open until the
upcoming PRs are complete?
> 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
> Priority: Major
> Fix For: 3.3.1
>
>
> 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]
