you should leave the `@deprecated`, but only on javadoc