updates to readme and chp1