changes name of function and adds some docs