An annotation is needed to enhanced @Deprecated annotation usage, and allow the creation of tools to strengthen the API life cycle.
As we don't have access to the JEP 277, we'll use a @DeprecatedFor annotation instead which will support the following attributes:
- since: the revision in which the annotated element became deprecated.
- CodeRemoval tags the deprecation for being removed in next revisions,
- CodeLegacy tags the deprecation as being maintained but which should be used only with extreme prudence.
A draft lives in https://github.com/nuxeo-sandbox/nuxeo-tools-deprecation