CLN: typing/mypy cleanup: Small fixes to make stubgen happy
No code changes, just moved a few comments, and fixed a few broken types.

This patch allows stubgen to run over the pandas codebase without generating errors