Update resource_jars attribute documentation.

Addressing comment in #13221 (comment)

PiperOrigin-RevId: 433668863

src/main/java/com/google/devtools/build/lib/bazel/rules/java/BazelJavaRuleClasses.java

@@ -221,10 +221,7 @@ class on the runtime classpath or you specify the <code>runtime_deps</code> argu
           <!-- #END_BLAZE_RULE.ATTRIBUTE --> */
           .add(attr("resource_strip_prefix", STRING))
           /* <!-- #BLAZE_RULE($java_rule).ATTRIBUTE(resource_jars) -->
-          Set of archives containing Java resources.
-          <p>
-            If specified, the contents of these jars are merged into the output jar.
-          </p>
+          Deprecated: Use java_import and deps or runtime_deps instead.
           <!-- #END_BLAZE_RULE.ATTRIBUTE --> */
           .add(
               attr("resource_jars", LABEL_LIST)