Enhance the rate-limiting documentation

Try and distil the things we've figured out over several months working on the rate-limiting project, with an SRE perspective.