DOC: some general doc/sphinx fixes
lgtm
 @jreback there were some lint issues introduced in https://github.com/pydata/pandas/pull/13710 (so travis for master will start to fail when it reaches that PR). But fixed them here
