doc and readme updates