[discussion]: add decorator for setting the description for a schema

Is there an existing issue that is already proposing this?

• I have searched the existing issues

Is your feature request related to a problem? Please describe it

OpenAPI allows a description not only for single properties but also for a complete schema. This can be optionally validated via no_schema_description in OpenAPI validator. Currently I see no way to set this description via a decorator.

Describe the solution you’d like

In correspondence with (PR 983)[https://github.com/nestjs/swagger/pull/983], where ApiSchema would be used with property name, this could work with a decorator named ApiSchema and a property named description, e.g.

@ApiSchema({ description: "Describing my schema" })
class MyDto {}

Teachability, documentation, adoption, migration strategy

No response

What is the motivation / use case for changing the behavior?

Richer OpenAPI documentation with descriptions for schemata

[kamilmysliwiec]

Use #983 as a base branch and create a PR to that branch

[raplemie]

Could the “title” be included as well ?