chore: updates README.md

README.md

@@ -477,6 +477,62 @@ const res = await rep.find({
 
 *i. Направление порядка `ASC` указывать необязательно.*
 
+### include
+
+Параметр включает связанные документы в результат вызываемого метода.
+Названия включаемых связей должны быть определены в текущей модели.
+(см. [Связи](#Связи))
+
+**Примеры**
+
+Включение связи по названию.
+
+```js
+const res = await rep.find({
+  include: 'city',
+});
+```
+
+Вложенное включение связей.
+
+```js
+const res = await rep.find({
+  include: {
+    city: 'country',
+  },
+});
+```
+
+Включение нескольких связей.
+
+```js
+const res = await rep.find({
+  include: [
+    'city',
+    'address',
+    'employees'
+  ],
+});
+```
+
+Использование фильтрации для включаемой связи.
+
+```js
+const res = await rep.find({
+  include: {
+    relation: 'employees', // название связи
+    scope: { // фильтрация документов "employees"
+      where: {active: true}, // условия выборки
+      order: 'id', // порядок документов
+      limit: 10, // ограничение количества
+      skip: 5, // пропуск документов
+      fields: ['name', 'surname'], // только указанные поля
+      include: 'city', // включение связей для "employees"
+    },
+  },
+});
+```
+
 ## Связи
 
 Параметр `relations` находится в составе определения модели и принимает