more README and documentation updates