Readme tweaks.

TODO: Conform to standard docstring @param/@return format.