notes and readme updates