human
Here's a good function header given the following:
I wrote the below code

    if add_deprecation_to_docstring:
        header = ('..    deprecated::    %s    (pending)    %s' % (version, (message or '')))
    else:
        header = None
    if (message is None):
        message = 'Call    to    deprecated    function    %(func)s'
    def decorate(fn):
        return _decorate_with_warning(fn, exc.SAPendingDeprecationWarning, (message % dict(func=fn.__name__)), header)
    return decorate

What's a good function header?
assistant
#Here's a good function header.

def pending_deprecation(version, message=None, add_deprecation_to_docstring=True):