various tweaks and cleanups

decided to do a PR against your PR so you can see what i am doing.
okay. i just felt it looks bad with the readthedocs theme we have.