Github user feynmanliang commented on a diff in the pull request:
https://github.com/apache/spark/pull/8498#discussion_r38233062
--- Diff: docs/mllib-guide.md ---
@@ -56,71 +63,63 @@ This lists functionality included in `spark.mllib`, the
main MLlib API.
* [limited-memory BFGS
(L-BFGS)](mllib-optimization.html#limited-memory-bfgs-l-bfgs)
* [PMML model export](mllib-pmml-model-export.html)
-MLlib is under active development.
-The APIs marked `Experimental`/`DeveloperApi` may change in future
releases,
-and the migration guide below will explain all changes between releases.
-
# spark.ml: high-level APIs for ML pipelines
-Spark 1.2 introduced a new package called `spark.ml`, which aims to
provide a uniform set of
-high-level APIs that help users create and tune practical machine learning
pipelines.
-
-*Graduated from Alpha!* The Pipelines API is no longer an alpha
component, although many elements of it are still `Experimental` or
`DeveloperApi`.
-
-Note that we will keep supporting and adding features to `spark.mllib`
along with the
-development of `spark.ml`.
-Users should be comfortable using `spark.mllib` features and expect more
features coming.
-Developers should contribute new algorithms to `spark.mllib` and can
optionally contribute
-to `spark.ml`.
-
-Guides for `spark.ml` include:
+**[spark.ml programming guide](ml-guide.html)** provides an overview of
the Pipelines API and major
+concepts. It also contains sections on using algorithms within the
Pipelines API, for example:
-* **[spark.ml programming guide](ml-guide.html)**: overview of the
Pipelines API and major concepts
-* Guides on using algorithms within the Pipelines API:
- * [Feature transformers](ml-features.html), including a few not in the
lower-level `spark.mllib` API
- * [Decision trees](ml-decision-tree.html)
- * [Ensembles](ml-ensembles.html)
- * [Linear methods](ml-linear-methods.html)
+* [Feature extractors and transformers](ml-features.html)
+* [Linear methods](ml-linear-methods.html)
+* [Decision trees](ml-decision-tree.html)
+* [Ensembles](ml-ensembles.html)
+* [Artificial neural network](ml-ann.html)
--- End diff --
This is referred to as multilayer perceptron in `ml-guide`, we should be
consistent with how we refer to it (I prefer MLP because ANN usually include
other flavors e.g. convnets, RBMs); `ml-ann.md` will also have to be renamed if
we make this change
---
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 [email protected] or file a JIRA ticket
with INFRA.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
