revert: docu(@nestjs/swagger) Describe @ApiSchema decorator

This reverts commit b8d782c.

Author: Stefan Radacovsky

content/openapi/decorators.md

@@ -22,5 +22,4 @@ All of the available OpenAPI decorators have an `Api` prefix to distinguish them
 | `@ApiProperty()`         | Model               |
 | `@ApiPropertyOptional()` | Model               |
 | `@ApiHideProperty()`     | Model               |
-| `@ApiSchema()`           | Model               |
 | `@ApiExtension()`        | Method              |

content/openapi/model-schema.md renamed to content/openapi/types-and-parameters.md

@@ -288,15 +288,3 @@ 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
-
-As you might have noticed the name of the generated model schema matches the name of the model class e.g. `CreateCatDto` will generate `CreateCatDto` schema. If you want to change the generated schema name then use `@ApiSchema()` decorator.
-
-For example:
-```typescript
-@ApiSchema({ name: 'CreateCatRequest' })
-class CreateCatDto {}
-```
-
-The above model will translate into schema with name `CreateCatRequest`.

src/app/homepage/menu/menu.component.ts

@@ -181,8 +181,8 @@ export class MenuComponent implements OnInit {
       children: [
         { title: 'Introduction', path: '/openapi/introduction' },
         {
-          title: 'Model schema',
-          path: '/openapi/model-schema',
+          title: 'Types and Parameters',
+          path: '/openapi/types-and-parameters',
         },
         { title: 'Operations', path: '/openapi/operations' },
         { title: 'Security', path: '/openapi/security' },

src/app/homepage/pages/openapi/openapi.module.ts

@@ -10,24 +10,18 @@ import { OpenApiMigrationGuideComponent } from './migration-guide/migration-guid
 import { OperationsComponent } from './operations/operations.component';
 import { OpenApiOtherFeaturesComponent } from './other-features/other-features.component';
 import { OpenApiSecurityComponent } from './security/security.component';
-import { ModelSchemaComponent } from './model-schema/model-schema.component';
+import { TypesAndParametersComponent } from './types-and-parameters/types-and-parameters.component';
 
 const routes: Routes = [
   {
     path: 'introduction',
     component: IntroductionComponent,
     data: { title: 'OpenAPI (Swagger)' },
   },
-  {
-    path: 'model-schema',
-    component: ModelSchemaComponent,
-    data: { title: 'Model Schema - OpenAPI' },
-  },
-  // Keep old route to not break existing bookmarks
   {
     path: 'types-and-parameters',
-    component: ModelSchemaComponent,
-    data: { title: 'Model Schema - OpenAPI' },
+    component: TypesAndParametersComponent,
+    data: { title: 'Types and Parameters - OpenAPI' },
   },
   {
     path: 'operations',
@@ -69,7 +63,7 @@ const routes: Routes = [
 @NgModule({
   imports: [CommonModule, SharedModule, RouterModule.forChild(routes)],
   declarations: [
-    ModelSchemaComponent,
+    TypesAndParametersComponent,
     OpenApiMigrationGuideComponent,
     OpenApiOtherFeaturesComponent,
     OperationsComponent,

src/app/homepage/pages/openapi/model-schema/model-schema.component.ts renamed to src/app/homepage/pages/openapi/types-and-parameters/types-and-parameters.component.ts

@@ -2,8 +2,8 @@ import { ChangeDetectionStrategy, Component } from '@angular/core';
 import { BasePageComponent } from '../../page/page.component';
 
 @Component({
-  selector: 'app-openapi-model-schema',
-  templateUrl: './model-schema.component.html',
+  selector: 'app-openapi-types-parameters',
+  templateUrl: './types-and-parameters.component.html',
   changeDetection: ChangeDetectionStrategy.OnPush,
 })
-export class ModelSchemaComponent extends BasePageComponent {}
+export class TypesAndParametersComponent extends BasePageComponent {}