To follow the numpy docstring standard, there should be a short explanation (followed by a blank line) above the parameters section.