[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.
Perfectly fine with me, I have just pushed the changes.