[ 
https://issues.apache.org/jira/browse/JAMES-2699?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16800636#comment-16800636
 ] 

Gautier DI FOLCO commented on JAMES-2699:
-----------------------------------------

Thanks, here is the associated pull request, have a look please: 
https://github.com/linagora/james-project/pull/2266

> 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
>
> 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]

Reply via email to