update docs with new method