How Do You Structure Your OpenAPI Specs? Any Best Practices You Swear By? 🤔

I’ve been diving into OpenAPI spec best practices lately and wondering—how do you all approach structuring your OpenAPI specs to keep things manageable and maintainable as projects scale?

For instance, this blog post covers some useful practices for structuring specs and some basics. It got me thinking about what other developers are actually doing in the wild that are a little bit more of advanced techniques?

I’d love to hear your tips on organizing endpoints, handling complex schemas, or just avoiding the chaos that can come with growing APIs. Share your wisdom (or horror stories)! ty!