adding the "throttle" property to users and updating docs