fix docs for merging and throttling