housekeeping and final updates to readme