Stop letting examples lie: make your OpenAPI spec the single source of truth for docs, mocks, and agents
The same example payload is usually hand-copied into docs, a mock server, a Postman collection, and test fixtures, and then they drift. OpenAPI examples can drive all four from one document, but only if they are realistic, schema-valid, and cover success, empty, and error states.