[MRG] More documentation minor fixes

A PR I plan to keep open while I am browsing the documentation and bumping into minor things that can be improved.