mongodb/docs — pull request #1774 by devkev (2014-05-14 02:45:33+00:00)
Title: manage-sharded-cluster.txt: Clarify stopping the balancer

Strictly speaking, the statement after "sh.setBalancerState(false)" is correct. However it is extremely misleading, because it implies that the setBalancerState command will wait for any current balancing round to finish, which is not true. The "sh.stopBalancer()" helper is the safest way to disable the balancer.