Merge branch 'master' of https://github.com/nestjs/docs.nestjs.com; branch 'feat/lazy-swagger' of https://github.com/h4ad-forks/docs.nestjs.com into h4ad-forks-feat/lazy-swagger

Author: kamilmysliwiec

content/openapi/introduction.md

@@ -29,15 +29,15 @@ async function bootstrap() {
     .setVersion('1.0')
     .addTag('cats')
     .build();
-  const document = SwaggerModule.createDocument(app, config);
-  SwaggerModule.setup('api', app, document);
+  const documentFactory = () => SwaggerModule.createDocument(app, config);
+  SwaggerModule.setup('api', app, documentFactory);
 
   await app.listen(process.env.PORT ?? 3000);
 }
 bootstrap();
 ```
 
-> info **Hint** `document` (returned by the `SwaggerModule#createDocument()` method) is a serializable object conforming to [OpenAPI Document](https://swagger.io/specification/#openapi-document). Instead of hosting it via HTTP, you could also save it as a JSON/YAML file, and consume it in different ways.
+> info **Hint** The factory around `SwaggerModule#createDocument()` is only used to create the document when you actually request Swagger, saving some initialization time and is a serializable object conforming to [OpenAPI Document](https://swagger.io/specification/#openapi-document). Instead of hosting it via HTTP, you could also save it as a JSON/YAML file, and consume it in different ways.
 
 The `DocumentBuilder` helps to structure a base document that conforms to the OpenAPI Specification. It provides several methods that allow setting such properties as title, description, version, etc. In order to create a full document (with all HTTP routes defined) we use the `createDocument()` method of the `SwaggerModule` class. This method takes two arguments, an application instance and a Swagger options object. Alternatively, we can provide a third argument, which should be of type `SwaggerDocumentOptions`. More on this in the [Document options section](/openapi/introduction#document-options).
 
@@ -135,7 +135,7 @@ const options: SwaggerDocumentOptions =  {
     methodKey: string
   ) => methodKey
 };
-const document = SwaggerModule.createDocument(app, config, options);
+const documentFactory = () => SwaggerModule.createDocument(app, config, options);
 ```
 
 #### Setup options

content/openapi/other-features.md

@@ -58,10 +58,10 @@ async function bootstrap() {
     .addTag('cats')
     .build();
 
-  const catDocument = SwaggerModule.createDocument(app, options, {
+  const catDocumentFactory = () => SwaggerModule.createDocument(app, options, {
     include: [CatsModule],
   });
-  SwaggerModule.setup('api/cats', app, catDocument);
+  SwaggerModule.setup('api/cats', app, catDocumentFactory);
 
   const secondOptions = new DocumentBuilder()
     .setTitle('Dogs example')
@@ -70,10 +70,10 @@ async function bootstrap() {
     .addTag('dogs')
     .build();
 
-  const dogDocument = SwaggerModule.createDocument(app, secondOptions, {
+  const dogDocumentFactory = () => SwaggerModule.createDocument(app, secondOptions, {
     include: [DogsModule],
   });
-  SwaggerModule.setup('api/dogs', app, dogDocument);
+  SwaggerModule.setup('api/dogs', app, dogDocumentFactory);
 
   await app.listen(process.env.PORT ?? 3000);
 }

content/openapi/types-and-parameters.md

@@ -251,7 +251,7 @@ export class CreateCatDto {}
 Alternatively, you can pass an options object with the `extraModels` property specified to the `SwaggerModule#createDocument()` method, as follows:
 
 ```typescript
-const document = SwaggerModule.createDocument(app, options, {
+const documentFactory = () => SwaggerModule.createDocument(app, options, {
   extraModels: [ExtraModel],
 });
 ```