this should be a regular numpy style docstring (no `:param`).