updates to readme, making some of the comments shorter