[jira] [Created] (SPARK-18321) CLONE - ML 2.0 QA: API: Java compatibility, docs

["Joseph K. Bradley (JIRA)" <ji...@apache.org>]

Joseph K. Bradley created SPARK-18321:
-----------------------------------------

             Summary: CLONE - ML 2.0 QA: API: Java compatibility, docs
                 Key: SPARK-18321
                 URL: https://issues.apache.org/jira/browse/SPARK-18321
             Project: Spark
          Issue Type: Sub-task
          Components: Documentation, Java API, ML, MLlib
            Reporter: Joseph K. Bradley
            Assignee: yuhao yang
             Fix For: 2.0.0


Check Java compatibility for MLlib for this release.

Checking compatibility means:
* comparing with the Scala doc
* verifying that Java docs are not messed up by Scala type incompatibilities.  Some items to look out for are:
** Check for generic "Object" types where Java cannot understand complex Scala types.
*** *Note*: The Java docs do not always match the bytecode. If you find a problem, please verify it using {{javap}}.
** Check Scala objects (especially with nesting!) carefully.
** Check for uses of Scala and Java enumerations, which can show up oddly in the other language's doc.
* If needed for complex issues, create small Java unit tests which execute each method.  (The correctness can be checked in Scala.)

If you find issues, please comment here, or for larger items, create separate JIRAs and link here as "requires".
Note that we should not break APIs from previous releases.  So if you find a problem, check if it was introduced in this Spark release (in which case we can fix it) or in a previous one (in which case we can create a java-friendly version of the API).



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@spark.apache.org
For additional commands, e-mail: issues-help@spark.apache.org