These paragraphs (all those before the "Parameters" section) should be moved to the "Notes" section of the docstring).