updates to README and docs