Update README, revise module docstring

Since the module docstring is used in the rendered HTML docs, it
serves a different role from the README.