I looked through all deprecated objects in Resteasy javadoc and it seems that some occurences are really weak or without any suggestions.

Please read https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/deprecation/deprecation.html#javadoc_tag and enhance the used @deprecated tag in javadoc.

For affected objects see https://docs.jboss.org/resteasy/docs/3.0.13.Final/javadocs/index.html?deprecated-list.html, where are either general or not enough or no information.