Updated API documentation to better explain the default behaviour of 'throttle'.