add spaces between code and prose in docstring
less flowery api doc title
add link to docs in README
introduction to doc page
move api documentation into single file