change docstring to avoid triggering bug in Sphinx
incorporate dwf's feedback