updates to README and documentation