method docs and readme updates