Fixing a few links and lots of formatting in docs
Formatting (pep8 and docs) for Esoclass. May need to be rebased if PR 313 is merged.
Merge pull request #316 from bsipocz/fix_docs_links_and_pep8

Fix docs links, formatting and pep8