Fix docstring syntax for RST
Improve docstrings, documentation; add changelog
Add sample code to README
Include description in documentation index; remove code from README
Merge pull request #29 from hfaran/docup

Improve docstrings and documentation