fixes docs for params somewhat