oatpp / oatpp-swagger

OpenApi 3.0.0 docs + Swagger UI for oatpp services
https://oatpp.io/
Apache License 2.0
90 stars 51 forks source link

Please, add a way to define "description" field for DTO (Schema Object) #47

Open alex-wakizashi opened 2 years ago

alex-wakizashi commented 2 years ago

Hello, Please, add a way to annotate whole DTO (as Schema Object, property "description"), not only DTO fields.

Property "description" is defined here: https://swagger.io/specification/#schema-object at Swagger, and here: https://spec.openapis.org/oas/latest.html#schema-object , "4.8.24.1 Properties" in OpenAPI Specification.

Adding other properties and fields, defined in the specs, would also be good :)

Thanks!