remove distinction between enhancements and fixes
clean up apidoc
redesign documentation and cleanup docstrings

Several elements from the new documentation have been inspired or
outright stolen from Plumbum's excellent landing page.