comments and readme updates