I wrote up a polite version of my examples rant for the work blog! https://redocly.com/blog/openapi-examples