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

    _plotcommands = (u'acorr', u'angle_spectrum', u'arrow', u'axhline', u'axhspan', u'axvline', u'axvspan', u'bar', u'barh', u'broken_barh', u'boxplot', u'cohere', u'clabel', u'contour', u'contourf', u'csd', u'errorbar', u'eventplot', u'fill', u'fill_between', u'fill_betweenx', u'hexbin', u'hist', u'hist2d', u'hlines', u'imshow', u'loglog', u'magnitude_spectrum', u'pcolor', u'pcolormesh', u'phase_spectrum', u'pie', u'plot', u'plot_date', u'psd', u'quiver', u'quiverkey', u'scatter', u'semilogx', u'semilogy', u'specgram', u'stackplot', u'stem', u'step', u'streamplot', u'tricontour', u'tricontourf', u'tripcolor', u'triplot', u'violinplot', u'vlines', u'xcorr', u'barbs')
    _misccommands = (u'cla', u'grid', u'legend', u'table', u'text', u'annotate', u'ticklabel_format', u'locator_params', u'tick_params', u'margins', u'autoscale')
    cmappable = {u'contour': u'if    %(ret)s._A    is    not    None:    sci(%(ret)s)', u'contourf': u'if    %(ret)s._A    is    not    None:    sci(%(ret)s)', u'hexbin': u'sci(%(ret)s)', u'scatter': u'sci(%(ret)s)', u'pcolor': u'sci(%(ret)s)', u'pcolormesh': u'sci(%(ret)s)', u'hist2d': u'sci(%(ret)s[-1])', u'imshow': u'sci(%(ret)s)', u'quiver': u'sci(%(ret)s)', u'specgram': u'sci(%(ret)s[-1])', u'streamplot': u'sci(%(ret)s.lines)', u'tricontour': u'if    %(ret)s._A    is    not    None:    sci(%(ret)s)', u'tricontourf': u'if    %(ret)s._A    is    not    None:    sci(%(ret)s)', u'tripcolor': u'sci(%(ret)s)'}
    def format_value(value):
        u'\n                                Format    function    default    values    as    needed    for    inspect.formatargspec.\n                                The    interesting    part    is    a    hard-coded    list    of    functions    used\n                                as    defaults    in    pyplot    methods.\n                                '
        if isinstance(value, types.FunctionType):
            if (value.__name__ in (u'detrend_none', u'window_hanning')):
                return (u'=mlab.' + value.__name__)
            if...

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

def boilerplate_gen():