Add :examples key to OpenAPI.Spec.Schema

[McSym28]

examples key was added (and example is being deprecated) to Schema objects in OpenAPI 3.1.0.

Deprecated: The example property has been deprecated in favor of the JSON Schema examples keyword. Use of example is discouraged, and later versions of this specification may remove it.

from https://spec.openapis.org/oas/latest.html?#fixed-fields-19

The value of this keyword MUST be an array. There are no restrictions placed on the values within the array. When multiple occurrences of this keyword are applicable to a single sub-instance, implementations MUST provide a flat array of all values rather than an array of arrays.
This keyword can be used to provide sample JSON values associated with a particular schema, for the purpose of illustrating usage. It is RECOMMENDED that these values be valid against the associated schema.

from https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#section-9.5

[aj-foster]

Thank you! ❤️