readme updates, code comments