Merge branch 'radacovsky-document-ApiSchema-decorator'

Author: kamilmysliwiec

content/openapi/decorators.md

@@ -3,7 +3,7 @@
 All of the available OpenAPI decorators have an `Api` prefix to distinguish them from the core decorators. Below is a full list of the exported decorators along with a designation of the level at which the decorator may be applied.
 
 |                           |                     |
-| ------------------------- |---------------------|
+| ------------------------- | ------------------- |
 | `@ApiBasicAuth()`         | Method / Controller |
 | `@ApiBearerAuth()`        | Method / Controller |
 | `@ApiBody()`              | Method              |
@@ -19,6 +19,7 @@ All of the available OpenAPI decorators have an `Api` prefix to distinguish them
 | `@ApiOperation()`         | Method              |
 | `@ApiParam()`             | Method / Controller |
 | `@ApiProduces()`          | Method / Controller |
+| `@ApiSchema()`            | Model               |
 | `@ApiProperty()`          | Model               |
 | `@ApiPropertyOptional()`  | Model               |
 | `@ApiQuery()`             | Method / Controller |

content/openapi/types-and-parameters.md

@@ -324,3 +324,16 @@ pets: Pet[];
 > info **Hint** The `getSchemaPath()` function is imported from `@nestjs/swagger`.
 
 Both `Cat` and `Dog` must be defined as extra models using the `@ApiExtraModels()` decorator (at the class-level).
+
+#### Schema name
+
+As you may have noticed, the name of the generated schema is based on the name of the original model class (for example, the `CreateCatDto` model generates a `CreateCatDto` schema). If you'd like to change the schema name, you can use the `@ApiSchema()` decorator.
+
+Here’s an example:
+
+```typescript
+@ApiSchema({ name: 'CreateCatRequest' })
+class CreateCatDto {}
+```
+
+The model above will be translated into the `CreateCatRequest` schema.