OpenAPI Overlays for Test Fixtures and Mock Generation

Here is a tension I have watched play out on every API team I have ever worked with. The examples in your OpenAPI live a double life. On one hand they are marketing copy — the pretty product with the aspirational price and the tidy description that reads well in your reference documentation.