Rate limit documentation
Description
It would be very useful if the API rate limiting was documented somewhere so that API consumers know how to behave. I'm building an integration with GitLab which requires ingesting a lot of data about users' projects (commits, pull requests, issues, pipelines, etc.). I managed to dig up this and this about rate limiting, only to discover that rate limit reset info is not returned with 429 responses, making my backoff-and-retry logic besides the point.
Proposal
A section here and here on rate limiting, how to respect it, and how to deal with eventual 429 responses.
Thank you.