readme updates + minor code fixes