Add proposed docs for the rate limit error response
Merge pull request #294 from github/add-rate-limit-error-docs

Add proposed docs for the rate limit error response