TOC

def random_number_generator(arg1: int, arg2: str) -> int:
    """
    Summary line.

    Extended description of function. This typically
    spans several lines.

    Parameters
    ----------
    arg1
        some text about the first argument
    arg2
        what the second argument is about

    Returns
    -------
    int
        a randomly generated value
        apparently from the example in here
        http://www.sphinx-doc.org/en/stable/ext/example_numpy.html
        type needs to be repeated, maybe a typo in this doc

    """
    return 42