README updates

Not much here (seriously...), just something I noticed while looking through the code that wasn't clear in the `README`.  I am thinking I will add more as I see them.