The following paragraphs should go in a 'notes' section of the docstring.