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

    from pythinkingcleaner import Discovery
    discovery = Discovery()
    devices = discovery.discover()
    @util.Throttle(MIN_TIME_BETWEEN_SCANS, MIN_TIME_BETWEEN_FORCED_SCANS)
    def update_devices():
        'Update    all    devices.'
        for device_object in devices:
            device_object.update()
    dev = []
    for device in devices:
        for type_name in SWITCH_TYPES:
            dev.append(ThinkingCleanerSwitch(device, type_name, update_devices))
    add_devices(dev)

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

def setup_platform(hass, config, add_devices, discovery_info=None):