General documentation improvements.

Improved documentation across the board with inlince comments.
Make use of sphinx autodoc.
Merge pull request #8 from d0ugal/docs

Docs