more notes; minor README corrections