Add proposed docs for the rate limit error response

Let me know if you think this is the most appropriate place for this