update params docstrings