feat(): some content tweaks

Author: kamilmysliwiec

content/openapi/introduction.md

@@ -42,6 +42,8 @@ async function bootstrap() {
 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.
+
 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.
 
 Once we create a document, we can call the `setup()` method. It accepts:
@@ -64,8 +66,6 @@ The `SwaggerModule` automatically reflects all of your endpoints. Note that the
 
 > info **Hint** To generate and download a Swagger JSON file, navigate to `http://localhost:3000/api-json` (`swagger-ui-express`) or `http://localhost:3000/api/json` (`fastify-swagger`) in your browser (assuming that your Swagger documentation is available under `http://localhost:3000/api`).
 
-> `const document` above 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.
-
 #### Example
 
 A working example is available [here](https://github.com/nestjs/nest/tree/master/sample/11-swagger).

content/techniques/mongo.md

@@ -87,6 +87,8 @@ In case there are multiple owners, your property configuration should look as fo
 ```typescript
 @Prop({ type: [Types.ObjectId], ref: Owner.name })
 owner: Owner[];
+```
+
 Finally, the **raw** schema definition can also be passed to the decorator. This is useful when, for example, a property represents a nested object which is not defined as a class. For this, use the `raw()` function from the `@nestjs/mongoose` package, as follows:
 
 ```typescript