bug: parsing of annotations placed after parameters section fails about griffe HOT 1 CLOSED

Hello @HugoMVale, thanks for the report 🙂

Some time ago we updated our Numpydoc-style docstring parser to improve its compliance with the official style guide, which does not explicitly allow prose in between or after known sections.

Admonitions like !!! info are prose (Markdown markup), and therefore are not supported anymore after known sections like Parameters, etc..

Instead, please use the style-specific support for admonitions:

def foo(x: float) -> float:
    """Foo function.

    Note
    ----
    This works.

    Parameters
    ----------
    x : float
        Number

    Returns
    -------
    float
        Square of number.

    Note
    ----
    This works too.

    """
    return x**2

Closing, but feel free to comment further!

from griffe.