It's better to have the documentation in one place, instead of having some in the docstring and some additional information added to the reference documentation in `reference.rst`.
It's better to have the documentation in one place, instead of having some in the docstring and some additional information added to the reference documentation in `reference.rst`.