readme: revisions to readme document