Make sure each property in OAS has a description and an example

[bfabio]

Make sure each property in Open API Specification file has a description and an example field.

[bfabio]

https://github.com/daveshanley/vacuum does check for those, we can add it to the CI pipeline.