documentation and readme updates