DOC: troubleshoot docbuild
@jbrockmendel I reverted the original PR (https://github.com/pandas-dev/pandas/pull/37756), so that 1) other PRs don't miss doc errors because of CI being red and also 2) it's easier to give inline feedback on an open PR.

So if you reopen the original PR (or open a new one), then I am happy to give some feedback on the rst formatting. perfect, thank you