[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.
Faux ami: I believe that the proper English wording here is to "warrant".