[FIX][DOC] Fix broken links in ml-guide.md

and some minor changes in ScalaDoc.