Update documentation to reflect reality

Minor typos and corrections to bring the readme more inline with the source

A few notes I found while copying and pasting code into my own tests