further comments and readme changes