Fix errors in README and add some minor notes

@craigisrael Thanks for the gem, nice work!  Was using it and noticed some errors/outdated sections in README thought I should fix, let me know if there's anything else I can do to help.