Improve Documentation

[lgrahl]

There are already docstrings in the code and most of the (Python) code is well documented. Let's use Sphinx to parse and generate the API documentation and move all relevant parts from the wiki page and the readme file into that documentation.

We could definitely use some help from scripters to get a proper Getting Started section. Any kind of feedback is much appreciated.