made throttle API resemble other components'
throttle_period documentation