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

    T = current.T
    db = current.db
    s3db = current.s3db
    s3 = current.response.s3
    settings = current.deployment_settings
    def prep(r):
        if (extra_filter is not None):
            r.resource.add_filter(extra_filter)
        c = r.controller
        deploy = (c == 'deploy')
        vol = (c == 'vol')
        if s3.rtl:
            f = s3db.pr_phone_contact.value
            f.represent = s3_phone_represent
            f.widget = S3PhoneWidget()
        method = r.method
        if (method in ('form', 'lookup')):
            return True
        elif (method == 'profile'):
            s3db.pr_address
            list_fields = s3db.get_config('pr_address', 'list_fields')
            list_fields.append('comments')
            s3db.hrm_training.date.represent = (lambda d: S3DateTime.date_represent(d, utc=True))
            list_fields = ['course_id', 'training_event_id$site_id', 'date', 'hours', 'grade', 'comments']
            if deploy:
                list_fields.append('course_id$course_job_title.job_title_id')
            s3db.configure('hrm_training', list_fields=list_fields)
            s3db.hrm_experience
            s3db.configure('hrm_experience', list_fields=['employment_type', 'activity_type', 'organisation_id', 'organisation', 'job_title_id', 'job_title', 'responsibilities', 'start_date', 'end_date', 'hours', 'location_id', 'supervisor_id', 'comments'])
            table = r.table
            record = r.record
            person_id = record.person_id
            ptable = db.pr_person
            person = db((ptable.id == person_id)).select(ptable.first_name, ptable.middle_name, ptable.last_name, ptable.pe_id, limitby=(0, 1)).first()
            name = s3_fullname(person)
            pe_id = person.pe_id
            comments = table.organisation_id.represent(record.organisation_id)
            if record.job_title_id:
                comments = (SPAN(('%s,    ' % s3_unicode(table.job_title_id.represent(record.job_title_id)))), comments)
            contacts_widget =...

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

def hrm_human_resource_controller(extra_filter=None):