Expanded docs

We still need better overview and getting started pages (with examples!).

I also updated a number of docstrings so they can appear in the API reference.
Update dataset.py

Fixed incomplete docstring.
Merge pull request #16 from akleeman/expanded-docs

Expanded docs.