* I note this is not splitting one large one into small, but the actually starting with smaller ones, as the other commenter suggested

I store different api logic in their own files. Then I use yq to stitch them all together. After which, I use openapi-generator to make a yaml output.

https://gist.github.com/freshteapot/3637e8d2b5ecdf01b7d25246...

- yq version 3.4.1 (Worth noting, the example uses an out of date yq, so a few modifictaions might be needed)

https://github.com/mikefarah/yq