update to README and comments