[jira] [Created] (SPARK-18332) SparkR 2.1 QA: Programming guide update and migration guide

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

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

             Summary: SparkR 2.1 QA: Programming guide update and migration guide
                 Key: SPARK-18332
                 URL: https://issues.apache.org/jira/browse/SPARK-18332
             Project: Spark
          Issue Type: Sub-task
          Components: Documentation, GraphX, ML, MLlib
            Reporter: Joseph K. Bradley
            Priority: Critical


Before the release, we need to update the MLlib, GraphX, and SparkR Programming Guides.  Updates will include:
* Add migration guide subsection.
** Use the results of the QA audit JIRAs and [SPARK-13448].
* Check phrasing, especially in main sections (for outdated items such as "In this release, ...")

For MLlib, we will make the DataFrame-based API (spark.ml) front-and-center, to make it clear the RDD-based API is the older, maintenance-mode one.
* No docs for spark.mllib will be deleted; they will just be reorganized and put in a subsection.
* If spark.ml docs are less complete, or if spark.ml docs say "refer to the spark.mllib docs for details," then we should copy those details to the spark.ml docs.  This per-feature work can happen under [SPARK-14815].
* This big reorganization should be done *after* docs are added for each feature (to minimize merge conflicts).



--
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