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

As per discussions with Xiangrui, I've reorganized and edited the mllib documentation.
That's an interesting point. For linear regression, people created new names for different types of regularization, some of which even shadowed the original name. It would be nice to add a sentence to clarify that we are counting different regularization types.