updates to README and more comments