Verbose function snippet

[dmc-au]

I'd like to submit for consideration a 'verbose' function snippet that I use in conjunction with your other great snippets. It includes type hints and a docstring. The docstring is in line with the reStructuredText (reST) format.

It appears as follows:

def fname(arg: type) -> type:
    '''
    Function definition.

    :param arg: first param
    :returns: return
    '''

    return type