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

    def clip_attrs(items, s):
        return clipped_list([a.name for a in items], 1000, total_min=10, total='    (total:    {{}}    {})'.format(s))
    return OrderedDict([('Features', clip_attrs(domain.attributes, 'features')), ('Meta    attributes', (bool(domain.metas) and clip_attrs(domain.metas, 'meta    attributes'))), ('Target', (bool(domain.class_vars) and clip_attrs(domain.class_vars, 'targets    variables')))])

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

def describe_domain(domain):