DOC/BLD: fix annoying sphinx bugs

closes #3721. cc @jreback