updates to README and comments