more readme work, and fix issue with rejection states that I discovered along the way