Readme edits, pull-request and a fix?

Guess this is an extended description, just filling it out so I know that I did it and can see where/how it shows up.
I've also turned this into a pull request.