With Akka, some of the API doc indicates Scala or Java usage. I’d like to understand whether the feeling here is that labeling API doc with “Scala API” or “Java API” has been beneficial, or whether the function/method signature is sufficient given Scala vs Java types.
I’m probably not the right person to answer, but the intention is that it should be visible from a quick glance rather than having to parse the signature.
We have been moving more and more towards completely separate API packages; javadsl/scaladsl. That is probably a better end user experience. Sometimes we still have to use common types for practical reasons and then they may contain mixed Scala/Java APIs.