Add a README

Resolves #1

Also tidy up output example to reflect what we're returning.