SPARK-2830 [MLlib]: re-organize mllib documentation

As per discussions with Xiangrui, I've reorganized and edited the mllib documentation.
minor: This line is too long. We don't have a style guide for markdown files. Usually I would try to make each line contain at most 100 chars, and do not put more than one sentences in the same line.