mattpolzin / OpenAPIKit

Codable Swift OpenAPI implementation.
MIT License
284 stars 36 forks source link

Add `examples` and deprecate `example` within `JSONSchema` #201

Closed mattpolzin closed 2 years ago

mattpolzin commented 3 years ago

See the release notes, new spec.

Work off of the release/3_0 branch and work on types in the OpenAPIKit (not OpenAPIKit_3_0) module.

I am not entirely sure the degree to which example should be deprecated -- it could be just a code documentation comment or it could be legitimate Swift deprecation of functions that use it; heck, we could even entirely remove, although that feels unfaithful to the specification so I think that's the wrong approach.