DOC: Documentation fixes

Clean up documentation. Fix many problems that have crept in in new code. Closes all outstanding documentation issues for 0.6.
why are they intended ?
I did the same without intendation for gee.rst