update the method docs