Improve documentation generation

[guoguo12]

Currently, the documentation in the readme needs to be updated manually every time a docstring changes. This is bad. For consistency and convenience, we should generate the documentation page directly from the source using pydoc.

The documentation also belongs on its own page. It shouldn't be crammed into the readme.