Extract endpoints mounted to OpenAPI
What does this MR do and why?
This allows a more iterational approach to cover the whole API in the documentation. Running rake gitlab:openapi:generate
on master generates 17k additions to doc/api/openapi/openapi_v2.yaml
. This makes it hard to review changes.
If endpoints are mounted in a separate class that is only used to generate the OpenAPI documentation, we can add endpoints step by step and review each one until the documentation covers the full API.
How to set up and validate locally
- Run
rake gitlab:openapi:generate
onmaster
. - This generates a lot of changes.
- Run
rake gitlab:openapi:generate
onopenapi/limit-number-of-endpoints
. - This generates only a few changes that are due to an outdated documentation.
MR acceptance checklist
This checklist encourages us to confirm any changes have been analyzed to reduce risks in quality, performance, reliability, security, and maintainability.
-
I have evaluated the MR acceptance checklist for this MR.