[WIP][SPARK-1506][MLLIB] Documentation improvements for MLlib 1.0

Still a work in process.