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

As per discussions with Xiangrui, I've reorganized and edited the mllib documentation.
I fixed this particular example, though there are many other instances of long lines.  Perhaps I can create a separate PR that addresses this issue in all the mllib markdown files...