[SPARK-8517][ML][DOC] Reorganizes the spark.ml user guide

This PR moves pieces of the spark.ml user guide to reflect suggestions in SPARK-8517. It does not introduce new content, as requested. <img width="192" alt="screen shot 2015-12-08 at 11 36 00 am" src="https://cloud.githubusercontent.com/assets/7594753/11666166/e82b84f2-9d9f-11e5-8904-e215424d8444.png"> Author: Timothy Hunter <[email protected]> Closes apache#10207 from thunterdb/spark-8517.
markhamstra · Dec 9, 2015 · 765c67f · 765c67f
1 parent 3959489
commit 765c67f
Show file tree

Hide file tree

Showing 8 changed files with 1,752 additions and 81 deletions.
diff --git a/docs/_data/menu-ml.yaml b/docs/_data/menu-ml.yaml
@@ -1,10 +1,10 @@
-- text: Feature extraction, transformation, and selection
+- text: "Overview: estimators, transformers and pipelines"
+  url: ml-intro.html
+- text: Extracting, transforming and selecting features
   url: ml-features.html
-- text: Decision trees for classification and regression
-  url: ml-decision-tree.html
-- text: Ensembles
-  url: ml-ensembles.html
-- text: Linear methods with elastic-net regularization
-  url: ml-linear-methods.html
-- text: Multilayer perceptron classifier
-  url: ml-ann.html
+- text: Classification and Regression
+  url: ml-classification-regression.html
+- text: Clustering
+  url: ml-clustering.html
+- text: Advanced topics
+  url: ml-advanced.html
diff --git a/docs/ml-advanced.md b/docs/ml-advanced.md
@@ -0,0 +1,13 @@
+---
+layout: global
+title: Advanced topics - spark.ml
+displayTitle: Advanced topics
+---
+
+# Optimization of linear methods
+
+The optimization algorithm underlying the implementation is called
+[Orthant-Wise Limited-memory
+QuasiNewton](http://research-srv.microsoft.com/en-us/um/people/jfgao/paper/icml07scalable.pdf)
+(OWL-QN). It is an extension of L-BFGS that can effectively handle L1
+regularization and elastic net.
diff --git a/docs/ml-ann.md b/docs/ml-ann.md