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

    if (revision.reviewer == revision.creator):
        log.debug(('Revision    (id=%s)    reviewed    by    creator,    skipping    email' % revision.id))
        return
    log.debug(('Sending    reviewed    email    for    revision    (id=%s)' % revision.id))
    url = reverse('wiki.document_revisions', locale=document.locale, args=[document.slug])
    c = {'document_title': document.title, 'approved': revision.is_approved, 'reviewer': revision.reviewer, 'message': message, 'revisions_url': url, 'host': Site.objects.get_current().domain}
    msgs = []
    @email_utils.safe_translation
    def _make_mail(locale, user):
        if revision.is_approved:
            subject = _(u'Your    revision    has    been    approved:    {title}')
        else:
            subject = _(u'Your    revision    has    been    reviewed:    {title}')
        subject = subject.format(title=document.title)
        mail = email_utils.make_mail(subject=subject, text_template='wiki/email/reviewed.ltxt', html_template='wiki/email/reviewed.html', context_vars=c, from_email=settings.TIDINGS_FROM_ADDRESS, to_email=user.email)
        msgs.append(mail)
    for user in [revision.creator, revision.reviewer]:
        if hasattr(user, 'profile'):
            locale = user.profile.locale
        else:
            locale = settings.WIKI_DEFAULT_LANGUAGE
        _make_mail(locale, user)
    email_utils.send_messages(msgs)

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

@task()
@timeit
def send_reviewed_notification(revision, document, message):