Extend the README with many more details

Also removes some copy/paste errors.
@trek Yes, I saw that when reading through more thoroughly, but when scanning for the highlights and then looking at the examples (what I just discovered is my typical quick learn mode for a new lib) I glossed over that detail and then saw what looked like an inconsistency in the usage in the examples.