being more specific is properly overkill (e.g. if examples should always be added, it would lead to lots of duplication between schemas and operation examples)
examples should be provided in example or examples, not in a description
illustrate nuances: both example and examples (i.e. multiple) supported on OAS3 definitions, except schema object only supports example
OAS 3.1 also allows multiple examples on schemas, but we're not using it yet
Add a rule on examples:
exampleorexamples, not in a descriptionexampleandexamples(i.e. multiple) supported on OAS3 definitions, except schema object only supportsexample