Extend the README with many more details

Also removes some copy/paste errors.
All of the examples show this taking in a string, should that be reflected in the type here?