[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.
I am OK with this change. It is good practice.