documentation: add rate limit information

https://www.pivotaltracker.com/story/show/76624278