authz: improve `waitForRateLimit` docstring and tests timeout
Created by: unknwon
Follow up to address https://github.com/sourcegraph/sourcegraph/pull/10950#discussion_r429861195.
Improves docstring of waitForRateLimit and cap tests timeout 1s in case of error.