Github user srowen commented on the issue:
https://github.com/apache/spark/pull/14891
I think this kind of thing is fine to call out, but we haven't used this
convention, quite, elsewhere. The APIs are all "Scala-specific" unless
otherwise noted. Even then they're callable from Java, just not very
conveniently. There are some methods that exist specifically to make calling
from Java simpler. In other cases I've just seen this described with a sentence
of prose that says this is a convenience method for Java callers. That might be
more explanatory than just writing "Java-specific", because indeed even those
are callable from Scala and aren't that specific to Java.
I'd just note the methods that are Java-friendly, and borrow a sentence
from existing doc of similar methods.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastruct...@apache.org or file a JIRA ticket
with INFRA.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscr...@spark.apache.org
For additional commands, e-mail: reviews-h...@spark.apache.org
