[DOC] Various improvements to API dox.

same here