diff --git a/blog/.empty b/blog/.empty
deleted file mode 100644
index e69de29..0000000
diff --git a/blog/component-testing.mdx b/blog/component-testing.mdx
new file mode 100644
index 0000000..015ad70
--- /dev/null
+++ b/blog/component-testing.mdx
@@ -0,0 +1,176 @@
+---
+title: Компонентное тестирование
+slug: component-testing-intro
+hide_table_of_contents: false
+date: 2024-06-10T14:00
+---
+
+import Admonition from "@theme/Admonition";
+
+В testplane в экспериментальном режиме поддержали компонентное тестирование и unit-тесты, выполняющиеся в браузере.
+
+<!-- truncate -->
+
+Практически все современные веб-интерфейсы пишутся с использованием фреймворков (React, Vue, Svelte, ...) для упрощения создания и реиспользования компонентов. Такие компоненты важно тестировать в изоляции друг от друга, чтобы быть уверенным, что каждый компонент корректно справляется со своей работой. Точно так же как мы пишем unit-тесты отдельно от интеграционных. В Testplane уже поддержанно скриншотное тестирование компонентов с помощью [Storybook](https://storybook.js.org/), однако этот инструмент актуален не для всех проектов. Поэтому мы разработали ещё один вариант компонентного тестирования, который не требует использования Storybook.
+
+Данная возможность может быть полезна, если у вас в проекте используются React-компоненты. При этом тестов нет совсем или используются только тяжелые интеграционные тесты (т.е. проверяются целые страницы, содержащие множество компонентов). Согласно [пирамиде тестирования](https://martinfowler.com/articles/practical-test-pyramid.html), интеграционных тестов должно быть меньше всего так как они больше подвержены “флапам” и зачастую избыточны. Множество сценариев можно проверить с помощью компонентых тестов и тем самым сократить время выполнения тестов в CI и улучшить их стабильность.
+
+### Варианты реализации компонентного тестирования
+
+Компонентное тестирование — это вид тестирования, при котором логика работы веб-компонента проверяется в изоляции от веб-страницы, в которой он используется. Для того, чтобы выполнить такой тест, нужно уметь корректно рендерить компонент. Часто для этой задачи применяют [JSDom](https://github.com/jsdom/jsdom) (используется в [Jest](https://jestjs.io/)), который рендерит веб-компоненты с помощью виртуального рендеринга Node.js, т.е. без использования реального браузера. С одной стороны, это работает быстрее (браузер не поднимается), а с другой — менее стабильно, так как проверки выполняются не в реальном браузере. Второе популярное решение — это использовать очень быстрый dev-сервер [Vite](https://vitejs.dev/), который поддерживает множество фреймворков (React, Vue, Svelte, ...) и отвечает за рендеринг компонентов в изоляции.
+
+Мы остановились на варианте с использованием Vite, так как такой подход обеспечивает тестирование страницы более приближенное к реальности (как если бы ее открыл пользователь). При этом, сами тесты выполняются немного дольше, чем в jsdom. Но для нас самое главное стабильность и воспроизводимость результатов тестов, поэтому выбор был очевиден.
+
+<details>
+    <summary>Краткая информация о том, как это реализовано</summary>
+
+    - при указании опции `testRunEnv: 'browser'` в конфиге Testplane, будет использован браузерный раннер, который поднимает Vite на localhost с рандомным свободным портом (пользователь может выставить необходимый порт в конфиге Vite). Именно на этом поднятом сервере будут рендерится все пользовательские компоненты и выполняться все необходимые команды/проверки (т.е. прямо внутри браузера);
+    - затем читаются тесты в Node.js, т.е. как это делается и для интеграционных тестов. Это необходимо, чтобы все плагины работали корректно (речь про триггер событий при чтении тестов), а так же, чтобы была возможность запустить тесты из одного файла параллельно. Если бы тест читался только в контексте браузера, то приходилось бы запускать абсолютно все тесты внутри одного файла и критическое завершение в одном из них приводило бы к остановке всех последующих. Т.е. на данном этапе мы понимаем какие тесты нужно запустить;
+    - после чего, как обычно, поднимаются необходимые браузеры и в них запускаются тесты. Каждый тест перед выполнением пользовательского кода выполняет переход на поднятый сервер Vite. При выполнении такого запроса генерится специальный index.html, в который подгружаются все необходимые библиотеки:
+    - mocha — для чтения тестов;
+    - webdriverio — для использования инстанса браузера внутри самого браузера;
+    - expect — для выполнения проверок;
+    - и прочие внутренние модули, необходимые для корректной работы.
+    - при открытии index.html из Vite, браузер устанавливает websocket-соединение с мастер процессом Testplane для того, чтобы обмениваться необходимыми данными. Например, в случае, если в браузере вызывается конструкция `await browser.$("body").assertView("plain", "body")`, то очевидно, что она выполниться в самом браузере не может, так как внутри `assertView` нам необходим доступ к файловой системе. Поэтому, выполнение этой команды отправляется в мастер Testplane, который в свою очередь отправляет ее worker-у, в котором данный тест запущен. И именно worker выполняет переданную ему команду. Когда результат получен, он таким же образом отправляется назад в браузер. Все общение реализовано с помощью библиотеки [socket.io](https://socket.io/);
+    - после чего, в браузере начинает выполняться указанный тест, который по завершению возвращает результат в Node.js процесс.
+
+</details>
+
+### Как использовать?
+
+Будем настраивать тестирование react-компонентов, написанных на TypeScript. Поэтому, для начала установим необходимые зависимости:
+
+```bash
+npm i testplane vite @vitejs/plugin-react @testing-library/react --save-dev
+npm i react --save
+```
+
+Создаем Vite конфиг, в котором подключим плагин для поддержки React. Пример:
+
+```javascript
+// vite.config.ts
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+    plugins: [react()],
+});
+```
+
+Теперь настроим запуск тестов в браузере. Для этого укажем опцию [testRunEnv](https://github.com/gemini-testing/testplane/blob/master/docs/config.md#testrunenv). Пример:
+
+```javascript
+// .testplane.conf.ts
+export const {
+    // ...
+    system: {
+        // ...
+        testRunEnv: ['browser', { viteConfig: './vite.config.ts' }],
+    },
+    sets: {
+        linux: {
+            files: [
+                'src/tests/**/*.testplane.tsx'
+            ],
+            browsers: [
+                'chrome'
+            ]
+        },
+    },
+}
+```
+
+После чего можем написать тест, в котором просто выведем значение `document` в консоль без использования команды [browser.execute](/docs/v8/commands/browser/execute):
+
+```javascript
+// src/tests/test.testplane.tsx
+it("should log document", async () => {
+    console.log(document);
+});
+```
+
+Если бы такой тест выполнялся в окружении Node.js, то он бы упал с ошибкой `ReferenceError: document is not defined`. Но в нашем случае он будет выполнен прямо в браузере, где доступна глобальная переменная `document`. Поэтому, в логе браузера и терминала (про эту возможность расскажем ниже) мы увидим следующее:
+
+```
+{
+  location: {
+    ancestorOrigins: {},
+    href: 'http://localhost:56292/run-uuids/23d2af81-4259-425c-8214-c9e770d75ea4',
+    origin: 'http://localhost:56292',
+    protocol: 'http:',
+    host: 'localhost:56292',
+    hostname: 'localhost',
+    port: '56292',
+    pathname: '/run-uuids/23d2af81-4259-425c-8214-c9e770d75ea4',
+    search: '',
+    hash: ''
+  }
+}
+```
+
+Напишем более сложный тест с рендерингом react компонента:
+
+```javascript
+// src/tests/test.testplane.tsx
+import { useState } from "react";
+import { render } from "@testing-library/react";
+
+// Простой компонент с тайтлом и кнопкой-счетчиком
+function Component() {
+    const [count, setCount] = useState(0);
+
+    return (
+        <div id="root">
+            <h1>Testplane Component Testing</h1>
+            <button onClick={() => setCount(count => count + 1)}>count is {count}</button>
+        </div>
+    );
+}
+
+it("should render react button", async ({ browser }) => {
+    render(<Component />); // рендерим компонент на сгенеренной странице Vite
+
+    const button = await browser.$("button");
+
+    await button.click();
+    await button.click();
+
+    await expect(button).toHaveText("count is 2");
+});
+```
+
+С полноценно работающими примерами можно ознакомиться [здесь](https://github.com/gemini-testing/testplane/tree/master/examples/component-testing).
+
+<Admonition type="warning" title="На данный момент есть ограничения">
+    - поддерживаются только компоненты, написанные на React в файлах `.jsx` и `.tsx`. Поддержка Vue
+    также есть в планах; - нет доступа к `currentTest` из хуков и теста; - временно не
+    поддерживается плагин @testplane/global-hook.
+</Admonition>
+
+### Какие дополнительные возможности поддерживаются?
+
+#### Hot Module Replacement (HMR)
+
+В Vite поддерживается [HMR](https://vitejs.dev/guide/api-hmr.html). Это означает, что если изменить загруженный файл, то произойдет или ремаунт компонента, или полная перезагрузка страницы. В случае, если компонент описан в отдельном файле (т.е. не в одном файле с тестом), то будет выполнен ремаунт, но тест перезапущен не будет. А если изменить файл с тестом, то произойдет перезагрузка страницы, которая приведет к тому, что Testplane прервет выполнение текущего теста и запустит его заново. За счет такой возможности в Vite можно очень быстро разрабатывать компоненты и писать для них тесты. Рекомендуется использовать вместе с REPL-режимом.
+
+При изменении исходников компонента не происходит полного перезапуска теста (маунтится по новой только сам компонент). При этом, если изменить код теста, то происходит полный перезапуск.
+
+#### Использование инстанса browser и expect прямо в DevTools браузера
+
+В консоли браузера, в котором выполняется тест, доступны инстанс самого `browser` и инстанс `expect`. Это довольно удобно использовать при дебаге теста.
+
+#### Логи из консоли браузера в терминале
+
+Вызов команд `log`, `info`, `warn`, `error`, `debug` и `table` на объекте `console` в браузере приводят к тому, что отображается информация не только в DevTools браузера, но также и в терминале, из которого был запущен Testplane. Т.е. можно вызвать `console.log` в тесте/компоненте и затем увидеть результат его выполнения в терминале. Это также довольно удобно при дебаге теста.
+
+### Заключение
+
+Данная функциональность предоставляет нашим пользователям новые возможности:
+
+-   изолированное тестирование React-компонентов в реальном браузере;
+-   стабильность и воспроизводимость результатов тестов в сравнении с JSDom;
+-   поддержка HMR;
+-   доступ к инстансам browser/expect в DevTools браузера, для удобного дебага;
+-   отображение логов в терминале для повышения комфорта и увеличения скорости разработки.
+
+Переезжайте на Testplane и попробуйте новую возможность самостоятельно. В случае обнаружения проблем, приходите в [issue github](https://github.com/gemini-testing/testplane/issues) — мы вам обязательно поможем!
diff --git a/blog/rebranding.mdx b/blog/rebranding.mdx
new file mode 100644
index 0000000..3b55ac8
--- /dev/null
+++ b/blog/rebranding.mdx
@@ -0,0 +1,29 @@
+---
+title: Ребрендинг
+slug: testplane-rebranding
+hide_table_of_contents: false
+date: 2024-05-20T13:00
+---
+
+Представляем вашему вниманию... **Testplane**. Наш проект Hermione решил сменить имя — встречайте проверенный годами продукт в свежем образе!
+
+<!-- truncate -->
+
+Мы долго рассматривали все за и против и пришли к выводу, что новое имя — Testplane — наилучшим образом отражает наше видение и будущее развитие продукта:
+
+1. Мы планируем активно вкладываться в развитие инструмента в опенсорсе. Новое имя символизирует качественный переход в развитии инструмента.
+2. Мы стремимся создать полноценный бренд с товарным знаком, логотипом, фирменным визуальным стилем. Testplane — это название, которое как сочетает в себе отсылку к «испытательному полету», так и может читаться как "плоскость для тестирования".
+
+Суть продукта остаётся неизменной. Testplane — это тот же проект, который вы знали многие годы как Hermione, но в свежем, обновленном виде. Чтобы упростить переход, мы решили сохранить сквозную нумерацию версий: Testplane v8.x — это эквивалент Hermione v8.x.
+
+Если вы уже работаете с Hermione, обновление на Testplane займет всего несколько минут. Мы проектировали его как drop-in замену:
+
+-   Полная поддержка существующих плагинов Hermione.
+-   Понимание всех опций и переменных окружения Hermione.
+-   Полная совместимость конфигураций.
+-   Два бинарных файла (testplane и hermione) для плавного перехода (вы можете запускать и как hermione gui, и как testplane gui).
+-   Экспорт типов для TypeScript, включая как собственные типы Testplane, так и типы Hermione (включая hermioneCtx).
+
+Если же вы еще не пробовали Testplane — загляните в нашу документацию и начните ваше исследование с Testplane всего за пару минут!
+
+Благодарим за интерес к проекту! ✈️
diff --git a/docs/commands/browser/$$.mdx b/docs/commands/browser/$$.mdx
new file mode 100644
index 0000000..39d7494
--- /dev/null
+++ b/docs/commands/browser/$$.mdx
@@ -0,0 +1,87 @@
+import Admonition from "@theme/Admonition";
+
+# $$
+
+## Обзор {#overview}
+
+Используйте команду `$$` вместо [findElements][find-elements] как более краткую команду, чтобы получить несколько элементов на странице.
+
+Команда `$$` возвращает массив с искомыми элементами, на каждом из которых можно вызывать команды действия без передачи селектора. Однако, если вы все же передадите селектор, то сначала будет найден соответствующий элемент, а затем вызвано действие для этого элемента.
+
+Вы можете связать `$` или `$$` вместе, чтобы спуститься по дереву DOM.
+
+<Admonition type="info">
+    Подробнее о том, как выбрать определенные элементы, смотрите в рецепте «[Как использовать
+    селекторы][how-to-use-selectors]».
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$$(selector);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>selector</td><td>String или Function</td><td>Селектор или JS-функция для получения множества элементов.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```html
+<ul id="menu">
+    <li>
+        <a href="/">Home</a>
+    </li>
+    <li>
+        <a href="/">Developer Guide</a>
+    </li>
+    <li>
+        <a href="/">API</a>
+    </li>
+    <li>
+        <a href="/">Contribute</a>
+    </li>
+</ul>
+```
+
+**$.js**
+
+```javascript
+it("should get text a menu link", async ({ browser }) => {
+    const text = await browser.$$("#menu")[0];
+
+    console.log(await text.$$("li")[2].$("a").getText()); // выведет: "API"
+});
+
+it("should get text a menu link - JS Function", async ({ browser }) => {
+    const text = await browser.$$(function () {
+        // Использовать здесь стрелочную функцию нельзя.
+        // Это Window – https://developer.mozilla.org/en-US/docs/Web/API/Window
+        //
+        // TypeScript-пользователи могут сделать что-нибудь вроде:
+        // return (this as Window).document.querySelectorAll('#menu')
+        return this.document.querySelectorAll("#menu"); // Element[]
+    })[0];
+
+    console.log(await text.$$("li")[2].$("a").getText()); // выведет: "API"
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.$](./$)
+-   [element.$](../element/$)
+-   [element.$$](../element/$$)
+
+[find-elements]: https://webdriver.io/docs/api/webdriver/#findelements
+[how-to-use-selectors]: https://webdriver.io/docs/selectors
diff --git a/docs/commands/browser/$.mdx b/docs/commands/browser/$.mdx
new file mode 100644
index 0000000..fc0a39f
--- /dev/null
+++ b/docs/commands/browser/$.mdx
@@ -0,0 +1,114 @@
+---
+sidebar_position: 1
+---
+
+import Admonition from "@theme/Admonition";
+
+# $
+
+## Обзор {#overview}
+
+Используйте команду `$` вместо [findElement][find-element] как более краткую команду, чтобы получить один элемент на странице.
+
+Команда `$` возвращает объект, описывающий элемент, на котором можно вызывать команды действия без передачи селектора. Однако, если вы все же передадите селектор, то сначала будет найден соответствующий элемент, а затем вызвано действие для этого элемента. Вы также можете передать объект в качестве селектора, где объект содержит свойство `element-6066-11e4-a52e-4f735466cecf` со значением ссылки на элемент. Затем команда преобразует ссылку в расширенный элемент WebdriverIO.
+
+Вы можете связать `$` или `$$` вместе, чтобы спуститься по дереву DOM.
+
+<Admonition type="info">
+    Подробнее о том, как выбрать определенные элементы, читайте в рецепте «[Как использовать
+    селекторы][how-to-use-selectors]».
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>selector</td><td>String или Function или Matcher</td><td>Селектор или JS-функция для получения конкретного элемента.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```html
+<ul id="menu">
+    <li>
+        <a href="/">Home</a>
+    </li>
+    <li>
+        <a href="/">Developer Guide</a>
+    </li>
+    <li>
+        <a href="/">API</a>
+    </li>
+    <li>
+        <a href="/">Contribute</a>
+    </li>
+</ul>
+```
+
+**$.js**
+
+```javascript
+it("should get text a menu link", async ({ browser }) => {
+    const text = await browser.$("#menu");
+
+    console.log(await text.$$("li")[2].$("a").getText()); // выведет: "API"
+});
+
+it("should get text a menu link - JS Function", async ({ browser }) => {
+    const text = await browser.$(function () {
+        // Использовать здесь стрелочную функцию нельзя.
+        // Это Window – https://developer.mozilla.org/en-US/docs/Web/API/Window
+        //
+        // TypeScript-пользователи могут сделать что-нибудь вроде:
+        // return (this as Window).document.querySelector('#menu')
+        return this.document.querySelector("#menu"); // Element
+    });
+
+    console.log(await text.$$("li")[2].$("a").getText()); // выведет: "API"
+});
+
+it("should allow to convert protocol result of an element into a WebdriverIO element", async ({
+    browser,
+}) => {
+    const activeElement = await browser.getActiveElement();
+
+    console.log(await browser.$(activeElement).getTagName()); // выведет активный элемент
+});
+
+it("should use Androids DataMatcher or ViewMatcher selector", async ({ browser }) => {
+    const menuItem = await browser.$({
+        name: "hasEntry",
+        args: ["title", "ViewTitle"],
+        class: "androidx.test.espresso.matcher.ViewMatchers",
+    });
+    await menuItem.click();
+
+    const menuItem = await browser.$({
+        name: "hasEntry",
+        args: ["title", "ViewTitle"],
+    });
+    await menuItem.click();
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.$$](./$$)
+-   [element.$](../element/$)
+-   [element.$$](../element/$$)
+
+[find-element]: https://webdriver.io/docs/api/webdriver/#findelement
+[how-to-use-selectors]: https://webdriver.io/docs/selectors
diff --git a/docs/commands/browser/action.mdx b/docs/commands/browser/action.mdx
new file mode 100644
index 0000000..0583624
--- /dev/null
+++ b/docs/commands/browser/action.mdx
@@ -0,0 +1,161 @@
+import Admonition from "@theme/Admonition";
+
+# action
+
+## Обзор {#overview}
+
+Используйте команду `action`, чтобы выполнить действия ввода в одном из виртуализируемых устройств в веб-браузере.
+
+В отличие от высокоуровневых команд [scrollIntoView][scrollIntoView] и [doubleClick][doubleClick], Actions API обеспечивает более гранулярное управление устройствами ввода. Доступны следующие источники ввода:
+
+-   ввод текста с клавиатуры для клавиатурных устройств;
+-   управление мышью, пером или сенсорным устройством;
+-   управление скроллом для устройств с колесом прокрутки.
+
+Каждая цепочка вызовов `action` команд должна завершаться вызовом команды `perform`, чтобы начать выполнение указанного набора действий. Также это приводит к высвобождению всех нажатых клавиш, кнопок и т.д. на виртуальных устройствах ввода и запускает необходимые события. Высвобождение можно пропустить, передав аргумент `true` в команду `perform`. Пример:
+
+```typescript
+await browser.action(...).perform(true);
+```
+
+<Admonition type="info">
+    Поддержка данной команды и конкретных действий может различаться в зависимости от среды
+    выполнения. За ходом разработки можно следить на [wpt.fyi][web-platform-tests]. Для мобильных
+    устройств вы можете использовать специальные команды жестов [Appium][appium] на
+    [iOS][appium-ios] и [Android][appium-android].
+</Admonition>
+
+## Управление клавиатурой {#keyboard_control}
+
+Используется при указании `key` в качестве аргумента команды `action`. Пример:
+
+```typescript
+await browser.action("key");
+```
+
+Возвращает объект `KeyAction`, который поддерживает следующие действия:
+
+-   `down(value: string)` — создает действие нажатия клавиши;
+-   `up(value: string)` — создает действие отпускания клавиши;
+-   `pause(ms: number)` — указывает, что источник ввода ничего не делает указанное количество времени.
+
+### Специальные символы {#special_symbols}
+
+Для использования специальных символов (`Control`, `Page Up`, `Shift` и т.д.) можно использовать объект `Key` из пакета [webdriverio][webdriverio-npm]. В нем содержатся unicode представления всех нужных специальных символов. Пример:
+
+```typescript
+import { Key } from "webdriverio";
+
+await browser.action("key").down(Key.Ctrl).perform();
+```
+
+### Примеры использования {#keyboard_examples}
+
+```typescript
+import { Key } from "webdriverio";
+
+it("should emit key events using key action commands", async ({ browser }) => {
+    const elem = await browser.$("input");
+    await elem.click(); // сделать элемент активным
+
+    await browser.action("key").down("f").down("o").down("o").up("f").up("o").up("o").perform();
+
+    console.log(await elem.getValue()); // возвращает "foo"
+
+    // скопировать значение из элемента input
+    await browser.action("key").down(Key.Ctrl).down("c").pause(10).up(Key.Ctrl).up("c").perform();
+});
+```
+
+Вместо серии `down/up` событий лучше использовать команду `setValue`. Пример исключительно для демонстрации принципов работы команды `action`.
+
+## Управление указателем {#pointer_control}
+
+Используется при указании `pointer` в качестве аргумента команды `action`, также можно указать тип указателя. Пример:
+
+```typescript
+await browser.action("pointer", {
+    parameters: { pointerType: "mouse" }, // "mouse" значение по умолчанию, также доступны: "pen" or "touch"
+});
+```
+
+Возвращает объект `PointerAction`, который поддерживает следующие действия:
+
+-   `down(button: 'left' | 'middle' | 'right')` — создает действие для нажатия одной клавиши;
+-   `down(params: PointerActionParams)` — создает действие для нажатия одной клавиши с подробными параметрами;
+-   `move(x: number, y: number)` — создает действие для перемещения указателя на `x` и `y` пикселей относительно вьюпорта;
+-   `move(params: PointerActionMoveParams)` — создает действие для перемещения указателя на `x` и `y` пикселей из указанного начала координат. Начало координат может быть определено как текущая позиция указателя, вьюпорта или центр определенного элемента;
+-   `up(button: 'left' | 'middle' | 'right')` — создает действие для отпускания одной клавиши;
+-   `up(params: PointerActionUpParams)` — создает действие для отпускания одной клавиши с подробными параметрами;
+-   `cancel()` — создает действие, которое отменяет текущее положение указателя;
+-   `pause(ms: number)` — указывает, что источник ввода ничего не делает указанное количество времени.
+
+Подробную информацию о типах параметров [PointerActionParams][pointer-action-params], [PointerActionMoveParams][pointer-action-move-params] и [PointerActionUpParams][pointer-action-up-params] можно найти в исходном коде webdriverio.
+
+### Примеры использования {#pointer_examples}
+
+```typescript
+it("drag and drop using pointer action command", async ({ browser }) => {
+    const origin = await browser.$("#source");
+    const targetOrigin = await browser.$("#target");
+
+    await browser
+        .action("pointer")
+        .move({ duration: 0, origin, x: 0, y: 0 })
+        .down({ button: 0 }) // левая кнопка
+        .pause(10)
+        .move({ duration: 0, origin: targetOrigin })
+        .up({ button: 0 })
+        .perform();
+});
+```
+
+## Управление колесом прокрутки {#scroll_wheel_control}
+
+Используется при указании `wheel` в качестве аргумента команды `action`. Пример:
+
+```typescript
+await browser.action("wheel");
+```
+
+Возвращает объект `WheelAction`, который поддерживает следующие действия:
+
+-   `scroll(params: ScrollParams)` — прокручивает страницу до указанных координат или до начала координат;
+-   `pause(ms: number)` — указывает, что источник ввода ничего не делает указанное количество времени.
+
+Подробную информацию о типе параметра [ScrollParams][scroll-params] можно найти в исходном коде webdriverio.
+
+### Примеры использования {#scroll_examples}
+
+```typescript
+it("should scroll using wheel action commands", async ({ browser }) => {
+    console.log(await browser.execute(() => window.scrollY)); // возвращает 0
+
+    await browser
+        .action("wheel")
+        .scroll({
+            deltaX: 0,
+            deltaY: 500,
+            duration: 200,
+        })
+        .perform();
+
+    console.log(await browser.execute(() => window.scrollY)); // возвращает 500
+});
+```
+
+## Связанные команды {#related}
+
+-   [actions](./actions)
+
+[scrollIntoView]: ../element/scrollIntoView
+[doubleClick]: ../element/doubleClick
+[web-platform-tests]: https://wpt.fyi/results/webdriver/tests/perform_actions?label=experimental&label=master&aligned
+[appium]: http://appium.io
+[appium-ios]: https://appium.github.io/appium-xcuitest-driver/latest/reference/execute-methods/#mobile-pinch
+[appium-android]: https://github.com/appium/appium-uiautomator2-driver#mobile-gesture-commands
+[webdriverio-npm]: https://www.npmjs.com/package/webdriverio
+[pointer-action-params]: https://github.com/webdriverio/webdriverio/blob/8ca026c75bf7c27ef9d574f0ec48d8bc13658602/packages/webdriverio/src/utils/actions/pointer.ts#L20-L35
+[pointer-action-move-params]: https://github.com/webdriverio/webdriverio/blob/8ca026c75bf7c27ef9d574f0ec48d8bc13658602/packages/webdriverio/src/utils/actions/pointer.ts#L20-L42
+[pointer-action-up-params]: https://github.com/webdriverio/webdriverio/blob/8ca026c75bf7c27ef9d574f0ec48d8bc13658602/packages/webdriverio/src/utils/actions/pointer.ts#L13-L19
+[scroll-params]: https://github.com/webdriverio/webdriverio/blob/8ca026c75bf7c27ef9d574f0ec48d8bc13658602/packages/webdriverio/src/utils/actions/wheel.ts#L4-L29
diff --git a/docs/commands/browser/actions.mdx b/docs/commands/browser/actions.mdx
new file mode 100644
index 0000000..e7dd741
--- /dev/null
+++ b/docs/commands/browser/actions.mdx
@@ -0,0 +1,28 @@
+# actions
+
+## Обзор {#overview}
+
+Используйте команду `actions`, чтобы выполнить несколько действий ввода в одном из виртуализируемых устройств в веб-браузере. Например для имитации масштабирования страницы. Больше подробной информации представлено в описании команды [action][action].
+
+## Использование {#usage}
+
+```typescript
+await browser.actions([action1, action2, ...]);
+```
+
+## Примеры использования {#examples}
+
+```typescript
+it("run multiple actions at once for a pinch zoom", async ({ browser }) => {
+    await browser.actions([
+        browser.action("pointer").move(500, 500).down().move(250, 250).up(),
+        browser.action("pointer").move(500, 500).down().move(750, 750).up(),
+    ]);
+});
+```
+
+## Связанные команды {#related}
+
+-   [action](./action)
+
+[action]: ./action
diff --git a/docs/commands/browser/addCommand.mdx b/docs/commands/browser/addCommand.mdx
new file mode 100644
index 0000000..ca43f45
--- /dev/null
+++ b/docs/commands/browser/addCommand.mdx
@@ -0,0 +1,65 @@
+import Admonition from "@theme/Admonition";
+
+# addCommand
+
+## Обзор {#overview}
+
+Используйте команду `addCommand`, чтобы добавить свою команду к браузеру _(browser)_ или к элементу _(element)_. Добавляемая команда может быть как синхронной, так и асинхронной.
+
+<Admonition type="info">
+    Подробнее о том, как добавлять свои кастомные команды, читайте в рецепте «[Как добавить свои
+    команды][how-to-add-custom-commands]».
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.addCommand(name, callback, elementScope);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>name</td><td>String</td><td>Имя кастомной команды.</td></tr>
+<tr><td>callback</td><td>Function</td><td>Функция-реализация команды.</td></tr>
+<tr><td>elementScope</td><td>Boolean</td><td>Если значение _true_, то добавить команду к элементу, а не к браузеру. По умолчанию: _false_.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+// добавляем команду getUrlAndTitle
+await browser.addCommand("getUrlAndTitle", async function (customParam) {
+    return {
+        url: await this.getUrl(), // `this` здесь и ниже относится к объекту "browser"
+        title: await this.getTitle(),
+        customParam: customParam,
+    };
+});
+
+// используем новую команду getUrlAndTitle
+it("should use my add command", async ({ browser }) => {
+    await browser.url("https://webdriver.io");
+
+    const result = await browser.getUrlAndTitle("foobar");
+
+    assert.strictEqual(result.url, "https://webdriver.io");
+    assert.strictEqual(
+        result.title,
+        "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js",
+    );
+    assert.strictEqual(result.customParam, "foobar");
+});
+```
+
+## Связанные команды {#related}
+
+-   [overwriteCommand](./overwriteCommand)
+
+[how-to-add-custom-commands]: https://webdriver.io/docs/customcommands/#adding-custom-commands
diff --git a/docs/commands/browser/assertView.mdx b/docs/commands/browser/assertView.mdx
new file mode 100644
index 0000000..a01b4ef
--- /dev/null
+++ b/docs/commands/browser/assertView.mdx
@@ -0,0 +1,103 @@
+import Admonition from "@theme/Admonition";
+
+# assertView
+
+## Обзор {#overview}
+
+Используйте команду `assertView`, чтобы снять скриншот для определенного состояния теста и сравнить его с эталонным.
+
+<Admonition type="info">
+    Эта команда реализована внутри testplane, в [API WebDriverIO][webdriverio-api] её нет.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.assertView(state, selector, options);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[state](#state)</td><td>String</td><td>Обязательный параметр. Название состояния теста. Должно быть уникальным в пределах одного теста.</td></tr>
+<tr><td>[selector](#selector)</td><td>String или String[]</td><td>Обязательный параметр. Селектор DOM-элемента, который необходимо заснять.</td></tr>
+<tr><td>[options](#options)</td><td>Object</td><td>Настройки команды _assertView_.</td></tr>
+
+</tbody>
+</table>
+
+### state
+
+Обязательный параметр. Задает название состояния теста. Название должно быть уникальным в пределах одного теста.
+
+### selector
+
+Обязательный параметр. Задает селектор DOM-элемента, который необходимо заснять.
+
+### options
+
+Задает настройки команды `assertView`:
+
+<table>
+<thead>
+<tr><td>**Опция**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>ignoreElements</td><td>Array или String</td><td>Элементы (задаются как селекторы), которые будут проигнорированы при сравнении скриншотов. Игнор реализуется с помощью закраски перечисленных элементов черным цветом. В случае одного элемента параметр можно задавать как строку.</td></tr>
+<tr><td>tolerance</td><td>Number</td><td>Чувствительность к разнице в цветам. Значение перетирает [browsers.tolerance][browsers-tolerance].</td></tr>
+<tr><td>antialiasingTolerance</td><td>Number</td><td>Чувствительность в антиалиасинге. Значение перетирает [browsers.antialiasingTolerance][browsers-antialiasing-tolerance].</td></tr>
+<tr><td>allowViewportOverflow</td><td>Boolean</td><td>По умолчанию testplane выдает ошибку, если элемент находится за пределами границ вьюпорта. Этот параметр отключает проверку на границы, позволяя снимать скриншоты элементов, не влезающих во вьюпорт. При этом на скриншоте будут видны только те части элемента, которые влезли во вьюпорт. Однако если _compositeImage_ равен _true_, то части элемента, которые оказались за _нижней_ границей вьюпорта, тоже будут видны на скриншоте. Аналогично если _captureElementFromTop_ равен _true_, то на скриншот попадут и те части элемента, которые оказались за пределами _верхней_ границы вьюпорта.</td></tr>
+<tr><td>captureElementFromTop</td><td>Boolean</td><td>Снимать скриншот элемента с самого верха. Если элемент находится за пределами вьюпорта, то к нему будет выполнен подскролл.</td></tr>
+<tr><td>compositeImage</td><td>Boolean</td><td>Позволяет тестировать элементы, не влезающие во вьюпорт по высоте.</td></tr>
+<tr><td>screenshotDelay</td><td>Number</td><td>Задержка в миллисекундах перед снятием скриншота. Может пригодиться, когда на странице есть элементы, использующие анимацию, или скроллбар, который исчезает не сразу и попадает на результирующий скриншот.</td></tr>
+<tr><td>selectorToScroll</td><td>String</td><td>Селектор, который нужно скроллировать. Может пригодиться, когда надо сделать скриншот модального окна, которое не помещается на экране. Иначе без указания селектора скролл будет применяться к объекту _window_, и скроллироваться будет задний фон, оставляя попап-окно на месте.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**example-1.js**
+
+```javascript
+it("should assert view", async ({ browser }) => {
+    await browser.url("some/url");
+    await browser.assertView("plain", ".button");
+
+    await browser.click(".button");
+    await browser.assertView("clicked", ".button");
+});
+```
+
+**example-2.js**
+
+```javascript
+it("should assert view with given options", async ({ browser }) => {
+    await browser.url("some/url");
+    await browser.assertView("plain", ".form", {
+        ignoreElements: [".link"],
+        tolerance: 5,
+        antialiasingTolerance: 4,
+        allowViewportOverflow: true,
+        captureElementFromTop: true,
+        compositeImage: true,
+        screenshotDelay: 10,
+        selectorToScroll: ".modal",
+    });
+});
+```
+
+## Связанные команды {#related}
+
+-   [element.assertView](../element/assertView)
+-   [browser.saveRecordingScreen](./saveRecordingScreen)
+-   [browser.saveScreenshot](./saveScreenshot)
+-   [element.saveScreenshot](../element/saveScreenshot)
+
+[webdriverio-api]: https://webdriver.io/docs/api
+[browsers-tolerance]: ../../config/browsers#tolerance
+[browsers-antialiasing-tolerance]: ../../config/browsers#antialiasing_tolerance
diff --git a/docs/commands/browser/call.mdx b/docs/commands/browser/call.mdx
new file mode 100644
index 0000000..f9cad7e
--- /dev/null
+++ b/docs/commands/browser/call.mdx
@@ -0,0 +1,55 @@
+# call
+
+## Обзор {#overview}
+
+Используйте команду `call` для выполнения любого асинхронного действия в тестах.
+
+Сама команда при этом обрабатывается как синхронная функция. Она принимает промис и останавливает свое выполнение до тех пор, пока промис не будет выполнен.
+
+## Использование {#usage}
+
+```javascript
+await browser.call(callback);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>callback</td><td>Function</td><td>Функция, которую нужно вызвать.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("some testing here", async ({ browser }) => {
+    await browser.url("http://google.com");
+
+    // делаем асинхронный вызов с помощью сторонней библиотеки,
+    // поддерживающей промисы, например, вызов к бэкенду или БД,
+    // чтобы сделать инъекцию фикстуры
+    await browser.call(() => {
+        return somePromiseLibrary.someMethod().then(() => {
+            // ...
+        });
+    });
+
+    // пример для асинхронного вызова сторонней библиотеки,
+    // не поддерживающей промисы
+    const result = await browser.call(() => {
+        return new Promise((resolve, reject) => {
+            someOtherNodeLibrary.someMethod(param1, (err, res) => {
+                if (err) {
+                    return reject(err);
+                }
+                resolve(res);
+            });
+        });
+    });
+});
+```
diff --git a/docs/commands/browser/debug.mdx b/docs/commands/browser/debug.mdx
new file mode 100644
index 0000000..dd39d33
--- /dev/null
+++ b/docs/commands/browser/debug.mdx
@@ -0,0 +1,27 @@
+# debug
+
+## Обзор {#overview}
+
+Используйте команду `debug`, чтобы остановить выполнение теста в браузере.
+
+Остановив работу теста, вы можете перейти в браузер, открыть _DevTools_ и в реальном времени проинспектировать web-страницу. Это может быть полезно для отладки теста.
+
+## Использование {#usage}
+
+```javascript
+await browser.debug();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it("should demonstrate the debug command", async ({ browser }) => {
+    await browser.$("#input").setValue("FOO");
+
+    await browser.debug(); // перейдите в браузер и измените значение #input на "BAR"
+
+    const value = await browser.$("#input").getValue();
+
+    console.log(value); // выведет: "BAR"
+});
+```
diff --git a/docs/commands/browser/deleteCookies.mdx b/docs/commands/browser/deleteCookies.mdx
new file mode 100644
index 0000000..83e6be9
--- /dev/null
+++ b/docs/commands/browser/deleteCookies.mdx
@@ -0,0 +1,65 @@
+# deleteCookies
+
+## Обзор {#overview}
+
+Используйте команду `deleteCookies`, чтобы удалить все или конкретные _cookies_ для текущей страницы.
+
+Чтобы удалить конкретные _cookies_, нужно указать имя _cookie_ в виде строки или список имен _cookies_ в виде массива строк.
+
+## Использование {#usage}
+
+```javascript
+await browser.deleteCookies(names);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>names</td><td>String или String[]</td><td>Необязательный параметр. Имя _cookie_ или список имен _cookies_, которые необходимо удалить. При отсутствии параметра будут удалены все _cookies_ для текущей страницы.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should delete cookies", async ({ browser }) => {
+    await browser.setCookies([
+        { name: "test", value: "123" },
+        { name: "test2", value: "456" },
+        { name: "test3", value: "789" },
+    ]);
+
+    let cookies = await browser.getCookies();
+    console.log(cookies);
+    // выведет:
+    // [
+    //     { name: 'test', value: '123' },
+    //     { name: 'test2', value: '456' }
+    //     { name: 'test3', value: '789' }
+    // ]
+
+    await browser.deleteCookies(["test3"]);
+
+    cookies = await browser.getCookies();
+    console.log(cookies);
+    // выведет:
+    // [
+    //     { name: 'test', value: '123' },
+    //     { name: 'test2', value: '456' }
+    // ]
+
+    await browser.deleteCookies();
+    cookies = await browser.getCookies();
+    console.log(cookies); // выведет: []
+});
+```
+
+## Связанные команды {#related}
+
+-   [getCookies](./getCookies)
+-   [setCookies](./setCookies)
diff --git a/docs/commands/browser/execute.mdx b/docs/commands/browser/execute.mdx
new file mode 100644
index 0000000..6b04ea1
--- /dev/null
+++ b/docs/commands/browser/execute.mdx
@@ -0,0 +1,55 @@
+# execute
+
+## Обзор {#overview}
+
+Используйте `execute`, чтобы выполнить _синхронно_ указанный JavaScript-код на странице текущего выбранного фрейма.
+
+Команда возвращает клиенту результат выполнения скрипта.
+
+Аргумент `script` определяет сценарий для выполнения в виде тела функции. Значение, возвращаемое этой функцией, будет возвращено клиенту. Функция будет вызвана с предоставленным массивом `args`, и доступ к значениям может быть получен через объект `arguments` в указанном порядке.
+
+Аргументами могут быть любые JSON-примитивы, массивы или объекты JSON. Объекты JSON, которые определяют ссылку на _WebElement,_ будут преобразованы в соответствующий элемент DOM. Аналогично, любые _WebElements_ в результате скрипта будут возвращены клиенту в виде объектов _WebElement JSON_.
+
+## Использование {#usage}
+
+```javascript
+await browser.execute(script, arguments);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>script</td><td>String или Function</td><td>Скрипт, который необходимо выполнить.</td></tr>
+<tr><td>arguments</td><td>Any</td><td>Необязательный параметр. Аргументы для скрипта.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should inject javascript on the page", async ({ browser }) => {
+    const result = await browser.execute(
+        (a, b, c, d) => {
+            // здесь мы в browser-контексте: доступа к консоли и к клиенту у нас нет
+            return a + b + c + d;
+        },
+        1,
+        2,
+        3,
+        4,
+    );
+
+    // здесь мы в node.js-контексте: доступ к консоли и к клиенту у нас есть
+    console.log(result); // выведет: 10
+});
+```
+
+## Связанные команды {#related}
+
+-   [executeAsync](./executeAsync)
+-   [setTimeout](./setTimeout)
diff --git a/docs/commands/browser/executeAsync.mdx b/docs/commands/browser/executeAsync.mdx
new file mode 100644
index 0000000..970b510
--- /dev/null
+++ b/docs/commands/browser/executeAsync.mdx
@@ -0,0 +1,59 @@
+# executeAsync
+
+## Обзор {#overview}
+
+Используйте команду `executeAsync`, чтобы выполнить _асинхронно_ указанный JavaScript-код на странице текущего выбранного фрейма.
+
+Последним аргументом команды должен быть колбэк, который будет вызван, как только скрипт завершит свою работу. В качестве входного параметра команда передает в колбэк результат выполнения скрипта.
+
+Аргумент `script` определяет сценарий для выполнения в виде тела функции. Функция будет вызвана с предоставленным массивом `args`, и доступ к значениям может быть получен через объект `arguments` в указанном порядке. Последним аргументом всегда должна быть колбэк-функция, которая будет вызвана после того, как скрипт будет выполнен.
+
+Аргументами могут быть любые JSON-примитивы, массивы или объекты JSON. Объекты JSON, которые определяют ссылку на _WebElement,_ будут преобразованы в соответствующий элемент DOM. Аналогично, любые _WebElements_ в результате скрипта будут возвращены клиенту в виде объектов _WebElement JSON_.
+
+## Использование {#usage}
+
+```javascript
+await browser.executeAsync(script, arguments);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>script</td><td>String или Function</td><td>Скрипт, который необходимо выполнить.</td></tr>
+<tr><td>arguments</td><td>Any</td><td>Аргументы для скрипта. Последним аргументом должна быть колбэк-функция, которая будет вызвана после того, как скрипт будет выполнен.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should execute async JavaScript on the page", async ({ browser }) => {
+    await browser.setTimeout({ script: 5000 });
+
+    const result = await browser.executeAsync(
+        function (a, b, c, d, done) {
+            // здесь мы в browser-контексте: доступа к консоли и к клиенту у нас нет
+            setTimeout(() => {
+                done(a + b + c + d);
+            }, 3000);
+        },
+        1,
+        2,
+        3,
+        4,
+    );
+
+    // здесь мы в node.js-контексте: доступ к консоли и к клиенту у нас есть
+    console.log(result); // выведет: 10
+});
+```
+
+## Связанные команды {#related}
+
+-   [execute](./execute)
+-   [setTimeout](./setTimeout)
diff --git a/docs/commands/browser/executionContext.mdx b/docs/commands/browser/executionContext.mdx
new file mode 100644
index 0000000..416b78a
--- /dev/null
+++ b/docs/commands/browser/executionContext.mdx
@@ -0,0 +1,41 @@
+import Admonition from "@theme/Admonition";
+
+# executionContext
+
+## Обзор {#overview}
+
+Во время прогона тестов testplane добавляет в `browser` свойство `executionContext` для хранения контекста исполнения.
+
+В свойстве `browser.executionContext` хранится текущий объект теста или хука \_Mocha, дополненный идентификатором браузера.
+
+<Admonition type="info">
+    Контекст исполнения добавляет testplane, в [API WebDriverIO][webdriverio-api] его нет.
+</Admonition>
+
+## Пример использования {#examples}
+
+```javascript
+it("should log execution context", async ({ browser }) => {
+    await browser.url("/foo/bar");
+
+    console.log("test", browser.executionContext);
+    // выведет:
+    // test: {
+    //   "title": "should log execution context",
+    //   "async": 0,
+    //   "sync": true,
+    //   "timedOut": false,
+    //   "pending": false,
+    //   "type": "test",
+    //   "body": "...",
+    //   "file": "/foo/bar/baz/qux.js",
+    //   "parent": "#<Suite>",
+    //   "ctx": "#<Context>",
+    //   "browserId": "chrome",
+    //   "meta": {},
+    //   "timer": {}
+    // }
+});
+```
+
+[webdriverio-api]: https://webdriver.io/docs/api
diff --git a/docs/commands/browser/getConfig.mdx b/docs/commands/browser/getConfig.mdx
new file mode 100644
index 0000000..8e406c0
--- /dev/null
+++ b/docs/commands/browser/getConfig.mdx
@@ -0,0 +1,27 @@
+# getConfig
+
+## Обзор {#overview}
+
+Используйте команду `getConfig`, чтобы получить [конфиг][browser-config] браузера.
+
+## Использование {#usage}
+
+```javascript
+await browser.getConfig();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it("some test", async ({ browser }) => {
+    const browserConfig = await browser.getConfig();
+    console.log(browserConfig.id);
+    // выведет: "chromeDesktop" – название конфигурации браузера, указанное в конфиге
+
+    const { browserName } = browserConfig.desiredCapabilities;
+    console.log(browserName);
+    // выведет: "chrome" – фактическое название браузера
+});
+```
+
+[browser-config]: ../../config/browsers#browser_main_settings
diff --git a/docs/commands/browser/getCookies.mdx b/docs/commands/browser/getCookies.mdx
new file mode 100644
index 0000000..db7c377
--- /dev/null
+++ b/docs/commands/browser/getCookies.mdx
@@ -0,0 +1,56 @@
+# getCookies
+
+## Обзор {#overview}
+
+Используйте команду `getCookies`, чтобы получить все или конкретные _cookies_ на текущей странице.
+
+Чтобы получить конкретные куки, нужно указать имя _cookie_ в виде строки или список имен _cookies_ в виде массива строк.
+
+## Использование {#usage}
+
+```javascript
+await browser.getCookies(names);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>names</td><td>String или String[]</td><td>Необязательный параметр. Имя _cookie_ или список имен _cookies_, которые необходимо получить. При отсутствии параметра будут возвращены все _cookies_ для текущей страницы.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should return a cookie for me", async ({ browser }) => {
+    await browser.setCookies([
+        { name: "test", value: "123" },
+        { name: "test2", value: "456" },
+    ]);
+
+    const testCookie = await browser.getCookies(["test"]);
+    console.log(testCookie);
+    // выведет:
+    // [
+    //    { name: 'test', value: '123' }
+    // ]
+
+    const allCookies = await browser.getCookies();
+    console.log(allCookies);
+    // выведет:
+    // [
+    //    { name: 'test', value: '123' },
+    //    { name: 'test2', value: '456' }
+    // ]
+});
+```
+
+## Связанные команды {#related}
+
+-   [setCookies](./setCookies)
+-   [deleteCookies](./deleteCookies)
diff --git a/docs/commands/browser/getMeta.mdx b/docs/commands/browser/getMeta.mdx
new file mode 100644
index 0000000..aff917f
--- /dev/null
+++ b/docs/commands/browser/getMeta.mdx
@@ -0,0 +1,64 @@
+import Admonition from "@theme/Admonition";
+
+# getMeta
+
+## Обзор
+
+Используйте команду `getMeta`, чтобы получить мета-информацию о тесте.
+
+Если указать ключ, то команда возвращает значение для конкретного ключа.
+Если ключ не указан, команда вернет объект со всей мета-информацией теста.
+
+Для установки значений в мета-информации используйте команду [setMeta](./setMeta).
+
+<Admonition type="info">
+    Эта команда реализована внутри testplane, в [API WebDriverIO][webdriverio-api] её нет.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.getMeta();
+```
+
+или
+
+```javascript
+await browser.getMeta(key);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>key</td><td>String</td><td>Необязательный параметр. Ключ, значение которого нужно получить из мета-информации теста.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should get meta info of test", async ({ browser }) => {
+    await browser.setMeta("foo", "bar");
+    await browser.url("/foo/bar?baz=qux");
+
+    const val = await browser.getMeta("foo");
+    console.log(val); // выведет: bar
+
+    const url = await browser.getMeta("url");
+    console.log(url); // выведет: /foo/bar?baz=qux
+
+    const meta = await browser.getMeta();
+    console.log(meta); // выведет: {foo: 'bar', url: '/foo/bar?baz=qux'}
+});
+```
+
+## Связанные команды {#related}
+
+-   [setMeta](./setMeta)
+
+[webdriverio-api]: https://webdriver.io/docs/api
diff --git a/docs/commands/browser/getPuppeteer.mdx b/docs/commands/browser/getPuppeteer.mdx
new file mode 100644
index 0000000..b2f1049
--- /dev/null
+++ b/docs/commands/browser/getPuppeteer.mdx
@@ -0,0 +1,47 @@
+import Admonition from "@theme/Admonition";
+
+# getPuppeteer
+
+## Обзор {#overview}
+
+Используйте команду `getPuppeteer`, чтобы получить инстанс [Puppeteer][puppeteer] браузера для последующего выполнения с его помощью специальных команд.
+
+Обратите внимание, что все команды [Puppeteer][puppeteer] по умолчанию асинхронны, поэтому, чтобы переключаться между синхронным и асинхронным выполнением, обязательно оберните вызовы [Puppeteer][puppeteer] в [browser.call][browser-call], как показано ниже в примере.
+
+<Admonition type="warning">
+Команда _getPuppeteer_ работает только при использовании _Chrome DevTools Protocol (CDP)_.
+
+Читайте подробности в разделе «[Как использовать Chrome DevTools Protocol в testplane][how-to-use-cdp]».
+
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.getPuppeteer();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it('should allow me to use Puppeteer', async ({ browser }) => {
+    await browser.url('https://webdriver.io');
+
+    const puppeteerBrowser = await browser.getPuppeteer();
+
+    // переключаемся на Puppeteer
+    const metrics = await browser.call(async () => {
+        await pages = await puppeteerBrowser.pages();
+
+        pages[0].setGeolocation({ latitude: 59.95, longitude: 30.31667 });
+
+        return pages[0].metrics();
+    });
+
+    console.log(metrics.LayoutCount); // выведет: 42
+});
+```
+
+[how-to-use-cdp]: ../../guides/how-to-use-cdp
+[puppeteer]: https://pptr.dev/#?product=Puppeteer&version=v5.1.0&show=api-class-browser
+[browser-call]: ./call
diff --git a/docs/commands/browser/getWindowSize.mdx b/docs/commands/browser/getWindowSize.mdx
new file mode 100644
index 0000000..b0f65f5
--- /dev/null
+++ b/docs/commands/browser/getWindowSize.mdx
@@ -0,0 +1,25 @@
+# getWindowSize
+
+## Обзор {#overview}
+
+Используйте команду `getWindowSize`, чтобы получить размер окна браузера.
+
+## Использование {#usage}
+
+```javascript
+await browser.getWindowSize();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it("should return browser window size", async ({ browser }) => {
+    const windowSize = await browser.getWindowSize();
+
+    console.log(windowSize); // выведет: { width: 1280, height: 767 }
+});
+```
+
+## Связанные команды {#related}
+
+-   [setWindowSize](./setWindowSize)
diff --git a/docs/commands/browser/keys.mdx b/docs/commands/browser/keys.mdx
new file mode 100644
index 0000000..b4abb9f
--- /dev/null
+++ b/docs/commands/browser/keys.mdx
@@ -0,0 +1,42 @@
+# keys
+
+## Обзор {#overview}
+
+Используйте команду `keys`, чтобы отправить последовательность нажатий клавиш в активный элемент.
+
+Вы можете также использовать символы «Левая стрелка» или «Правая стрелка». Они будут автоматически преобразованы в соответствующие unicode-символы. Все поддерживаемые символы вы можете посмотреть [здесь][keyboard-actions].
+
+Модификаторы типа `Ctrl`, `Shift`, `Alt` и `Meta` остаются нажатыми, пока вы сами не освободите их повторным вызовом. Однако модификация клика требует использования метода [performActions][perform-actions] из _WebDriver Actions API_.
+
+## Использование {#usage}
+
+```javascript
+await browser.keys(value);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>value</td><td>String или String[]</td><td>Последовательность клавиш, которые нужно напечатать.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("copies text out of active element", async ({ browser }) => {
+    // копируем текст из элемента ввода
+    await browser.$("#username").setValue("anonymous");
+
+    await browser.keys(["Meta", "a"]);
+    await browser.keys(["Meta", "c"]);
+});
+```
+
+[keyboard-actions]: https://w3c.github.io/webdriver/#keyboard-actions
+[perform-actions]: https://webdriver.io/docs/api/webdriver#performactions
diff --git a/docs/commands/browser/mock.mdx b/docs/commands/browser/mock.mdx
new file mode 100644
index 0000000..ef637c5
--- /dev/null
+++ b/docs/commands/browser/mock.mdx
@@ -0,0 +1,135 @@
+import Admonition from "@theme/Admonition";
+
+# mock
+
+## Обзор {#overview}
+
+Используйте команду `mock`, чтобы имитировать ответ на запрос.
+
+Вы можете включать имитацию в зависимости от урла, заголовков или статус-кода. Вызов метода `mock` возвращает объект-заглушку _(stub)_, который вы можете использовать, чтобы модифицировать ответ от веб-ресурса. С помощью объекта-заглушки вы можете возвращать ответ-имитацию или ронять запрос.
+
+Существует 3 способа модифицировать ответ:
+
+-   вернуть кастомный JSON-объект (например, чтобы имитировать ответ на API-запрос);
+-   заменить ответ локальным файлом (подсунуть модифицированный JavaScript-файл);
+-   перенаправить на другой URL и подсунуть полученный оттуда ответ.
+
+<Admonition type="warning">
+Команда _mock_ работает только при использовании _Chrome DevTools Protocol (CDP)_.
+
+Читайте подробности в разделе «[Как использовать Chrome DevTools Protocol в testplane][how-to-use-cdp]».
+
+А также читайте рецепт «[Как отслеживать и перехватывать сетевые запросы и ответы][how-to-intercept-requests-and-responses]».
+
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.mock(url, { method, headers, responseHeaders, postData, statusCode });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>url</td><td>String</td><td>URL, запрос которого нужно имитировать.</td></tr>
+<tr><td>method</td><td>String или Function</td><td>http-метод, по которому нужно фильтровать ресурс.</td></tr>
+<tr><td>headers</td><td>Object или Function</td><td>Заголовки запроса, по которым нужно фильтровать ресурс.</td></tr>
+<tr><td>responseHeaders</td><td>Object или Function</td><td>Заголовки ответа, по которым нужно фильтровать ресурс.</td></tr>
+<tr><td>postData</td><td>String или Function</td><td>postData запроса, по которому нужно фильтровать ресурс.</td></tr>
+<tr><td>statusCode</td><td>Number или Function</td><td>Код статуса, по которому нужно фильтровать ресурс.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should mock network resources", async ({ browser }) => {
+    // используем статическую строку
+    const userListMock = await browser.mock("**" + "/users/list");
+
+    // также мы можем имитировать ответы в зависимости
+    // от заголовков запроса или ответа, статус-кода, или postData
+    const strictMock = await browser.mock("**", {
+        // мокаем все json-ответы
+        statusCode: 200,
+        headers: { "Content-Type": "application/json" },
+        responseHeaders: { "Cache-Control": "no-cache" },
+        postData: "foobar",
+    });
+
+    // функция-компаратор
+    const apiV1Mock = await browser.mock("**" + "/api/v1", {
+        statusCode: statusCode => statusCode >= 200 && statusCode <= 203,
+        headers: headers =>
+            headers["Authorization"] && headers["Authorization"].startsWith("Bearer "),
+        responseHeaders: headers => headers["Impersonation"],
+        postData: data => typeof data === "string" && data.includes("foo"),
+    });
+});
+
+it("should modify API responses", async ({ browser }) => {
+    // фильтруем по методу
+    const todoMock = await browser.mock("**" + "/todos", {
+        method: "get",
+    });
+
+    // имитируем ответ эндпойнта заготовленной фикстурой
+    mock.respond([
+        {
+            title: "Injected Todo",
+            order: null,
+            completed: false,
+            url: "http://todo-backend-express-knex.herokuapp.com/916",
+        },
+    ]);
+
+    // отвечаем другим статус-кодом или заголовком
+    mock.respond(
+        [
+            {
+                title: "Injected Todo",
+                order: null,
+                completed: false,
+                url: "http://todo-backend-express-knex.herokuapp.com/916",
+            },
+        ],
+        {
+            statusCode: 404,
+            headers: {
+                "x-custom-header": "foobar",
+            },
+        },
+    );
+});
+
+it("should modify text assets", async ({ browser }) => {
+    const scriptMock = await browser.mock("**" + "/script.min.js");
+    scriptMock.respond("./tests/fixtures/script.js");
+});
+
+it("should redirect web resources", async ({ browser }) => {
+    const headerMock = await browser.mock("**" + "/header.png");
+    headerMock.respond("https://media.giphy.com/media/F9hQLAVhWnL56/giphy.gif");
+
+    const pageMock = await browser.mock("https://google.com/");
+    pageMock.respond("https://webdriver.io");
+    await browser.url("https://google.com");
+
+    console.log(await browser.getTitle());
+    // выведет: "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js"
+});
+```
+
+## Связанные команды {#related}
+
+-   [mockClearAll](./mockClearAll)
+-   [mockRestoreAll](./mockRestoreAll)
+
+[how-to-use-cdp]: ../../guides/how-to-use-cdp
+[how-to-intercept-requests-and-responses]: ../../guides/how-to-intercept-requests-and-responses
diff --git a/docs/commands/browser/mockClearAll.mdx b/docs/commands/browser/mockClearAll.mdx
new file mode 100644
index 0000000..e12c2ad
--- /dev/null
+++ b/docs/commands/browser/mockClearAll.mdx
@@ -0,0 +1,40 @@
+# mockClearAll
+
+## Обзор {#overview}
+
+Используйте команду `mockClearAll`, чтобы сбросить всю сохраненную информацию в зарегистрированных имитациях. Имитации регистрируются с помощью команды [mock][mock].
+
+## Использование {#usage}
+
+```typescript
+await browser.mockClearAll();
+```
+
+## Примеры использования {#examples}
+
+```typescript
+it("should clear all mocks", async ({ browser }) => {
+    const docMock = await browser.mock("**", {
+        headers: { "Content-Type": "text/html" },
+    });
+    const jsMock = await browser.mock("**", {
+        headers: { "Content-Type": "application/javascript" },
+    });
+
+    await browser.url("http://guinea-pig.webdriver.io/");
+    console.log(docMock.calls.length, jsMock.calls.length); // returns "1 4"
+
+    await browser.url("http://guinea-pig.webdriver.io/");
+    console.log(docMock.calls.length, jsMock.calls.length); // returns "2 4" (JavaScript comes from cache)
+
+    await browser.mockClearAll();
+    console.log(docMock.calls.length, jsMock.calls.length); // returns "0 0"
+});
+```
+
+## Связанные команды {#related}
+
+-   [mock][mock]
+-   [mockRestoreAll](./mockRestoreAll)
+
+[mock]: ./mock
diff --git a/docs/commands/browser/mockRestoreAll.mdx b/docs/commands/browser/mockRestoreAll.mdx
new file mode 100644
index 0000000..678da2b
--- /dev/null
+++ b/docs/commands/browser/mockRestoreAll.mdx
@@ -0,0 +1,37 @@
+# mockRestoreAll
+
+## Обзор {#overview}
+
+Используйте команду `mockRestoreAll`, чтобы восстановить информацию и поведение в зарегистрированных имитациях до их создания. Имитации регистрируются с помощью команды [mock][mock].
+
+## Использование {#usage}
+
+```typescript
+await browser.mockRestoreAll();
+```
+
+## Примеры использования {#examples}
+
+```typescript
+it("should restore all mocks", async ({ browser }) => {
+    const googleMock = await browser.mock("https://google.com/");
+    googleMock.respond("https://webdriver.io");
+    const wdioMock = await browser.mock("https://webdriver.io");
+    wdioMock.respond("http://json.org");
+
+    await browser.url("https://google.com/");
+    console.log(await browser.getTitle()); // JSON
+
+    await browser.mockRestoreAll();
+
+    await browser.url("https://google.com/");
+    console.log(await browser.getTitle()); // Google
+});
+```
+
+## Связанные команды {#related}
+
+-   [mock][mock]
+-   [mockClearAll](./mockClearAll)
+
+[mock]: ./mock
diff --git a/docs/commands/browser/newWindow.mdx b/docs/commands/browser/newWindow.mdx
new file mode 100644
index 0000000..582351c
--- /dev/null
+++ b/docs/commands/browser/newWindow.mdx
@@ -0,0 +1,57 @@
+import Admonition from "@theme/Admonition";
+
+# newWindow
+
+## Обзор {#overview}
+
+Используйте команду `newWindow`, чтобы открыть новое окно в браузере.
+
+Эта команда эквивалентна функции [window.open()][window-open].
+
+Обратите внимание, что при выполнении эта команда автоматически переключит вас в новое окно.
+
+<Admonition type="warning">Команда _newWindow_ не работает в мобильных окружениях (!)</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.newWindow(url, { windowName, windowFeatures });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>url</td><td>String</td><td>URL веб-сайта, который нужно открыть.</td></tr>
+<tr><td>windowName</td><td>String</td><td>Имя нового окна.</td></tr>
+<tr><td>windowFeatures</td><td>String</td><td>Настройки открываемого окна, например: _size_, _position_, _scrollbars_, и т. д.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should open a new tab", async ({ browser }) => {
+    await browser.url("http://google.com");
+    console.log(await browser.getTitle());
+    // выведет: "Google"
+
+    await browser.newWindow(
+        "https://webdriver.io",
+        "WebdriverIO window",
+        "width=420,height=230,resizable,scrollbars=yes,status=1",
+    );
+    console.log(await browser.getTitle());
+    // выведет: "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js"
+
+    await browser.closeWindow();
+    console.log(await browser.getTitle());
+    // выведет: "Google"
+});
+```
+
+[window-open]: https://developer.mozilla.org/en-US/docs/Web/API/Window/open
diff --git a/docs/commands/browser/openAndWait.mdx b/docs/commands/browser/openAndWait.mdx
new file mode 100644
index 0000000..671a78c
--- /dev/null
+++ b/docs/commands/browser/openAndWait.mdx
@@ -0,0 +1,72 @@
+# openAndWait
+
+## Обзор {#overview}
+
+Используйте команду `openAndWait` для открытия страницы и ожидания ее загрузки (по комбинации указанных факторов).
+
+Функции ожидания неактивности сети и падения по сетевым ошибкам доступны только при использовании браузеров с поддержкой _Chrome DevTools Protocol (CDP)_.
+
+## Использование {#usage}
+
+```javascript
+await browser.openAndWait("some/url", {
+    selector: [".some", ".selector"],
+    predicate: () => document.isReady,
+    ignoreNetworkErrorsPatterns: ["https://mc.yandex.ru", "https://avatars.mds.yandex.net/*"],
+    waitNetworkIdle: true,
+    waitNetworkIdleTimeout: 500,
+    failOnNetworkError: true,
+    timeout: 20000,
+});
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>url</td><td>String</td><td>Адрес страницы.</td></tr>
+<tr><td>WaitOpts</td><td>Object</td><td>Параметры ожидания страницы. Опционален, как и все его поля.</td></tr>
+
+</tbody>
+</table>
+
+### WaitOpts
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>selector</td><td>String\|String[]</td><td>Селектор (/селекторы) элемента (/элементов), которые должны существовать на загруженной странице.</td></tr>
+<tr><td>predicate</td><td>() => Promise&lt;bool&gt; \| bool</td><td>Предикат, возвращающий `true`, если страница загружена. Выполняется в браузерном контексте: [waitUntil](https://webdriver.io/docs/api/element/waitUntil).</td></tr>
+<tr><td>waitNetworkIdle</td><td>Boolean</td><td>Если `true`, ожидает окончания выполнения всех сетевых запросов. По умолчанию `true`. Работает только в CDP браузерах, игнорируется для остальных.</td></tr>
+<tr><td>waitNetworkIdleTimeout</td><td>Number</td><td>Время (в миллисекундах) после окончания всех сетевых запросов, чтобы считать сеть простаивающей. По умолчанию 500.</td></tr>
+<tr><td>failOnNetworkError</td><td>Boolean</td><td>Нужно ли бросать ошибку при сетевых ошибках. По умолчанию `true`. Работает только в CDP браузерах, игнорируется для остальных</td></tr>
+<tr><td>shouldThrowError</td><td>(match) => Boolean</td><td>Предикат, который должен вернуть `true` по [Match](https://webdriver.io/docs/api/mock#match), если сетевая ошибка считается критической для корректной загрузки страницы. По умолчанию, возвращает `true` для картинок, стилей и шрифтов.</td></tr>
+<tr><td>ignoreNetworkErrorsPatterns</td><td>Array&lt;String \| RegExp&gt;</td><td>Паттерны адресов ресурсов, для которых игнорируется проверка успешности загрузки. Имеет приоритет над `shouldThrowError`.</td></tr>
+<tr><td>timeout</td><td>Number</td><td>Таймаут открытия страницы. По умолчанию, используется значение `pageLoadTimeout`. Выбрасывается исключение, если по истечени времени селекторы все еще не существуют, или предикат все еще резолвит `false`</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("some test", async ({ browser }) => {
+    // С `waitNetworkIdle` также ожидаем загрузки картинок, шрифтов, стилей, игнорируя ошибки метрики
+    await browser.openAndWait("some/url", {
+        selector: [".selector"],
+        predicate: () => document.isReady,
+        ignoreNetworkErrorsPatterns: ["https://mc.yandex.ru"],
+        waitNetworkIdle: true,
+        waitNetworkIdleTimeout: 500,
+        failOnNetworkError: true,
+        timeout: 20000,
+    });
+
+    await browser.assertView("plain", ".selector");
+});
+```
diff --git a/docs/commands/browser/overwriteCommand.mdx b/docs/commands/browser/overwriteCommand.mdx
new file mode 100644
index 0000000..0edefd9
--- /dev/null
+++ b/docs/commands/browser/overwriteCommand.mdx
@@ -0,0 +1,57 @@
+import Admonition from "@theme/Admonition";
+
+# overwriteCommand
+
+## Обзор {#overview}
+
+Используйте команду `overwriteCommand`, чтобы переопределить уже существующие команды браузера _(browser)_ или элемента _(element)_.
+
+<Admonition type="info">
+    Читайте также рецепт «[Как добавить свои команды][how-to-add-custom-commands]».
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.overwriteCommand(name, callback, elementScope);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>name</td><td>String</td><td>Имя кастомной команды.</td></tr>
+<tr><td>callback</td><td>Function</td><td>Функция-реализация команды.</td></tr>
+<tr><td>elementScope</td><td>Boolean</td><td>Если значение _true_, то добавить команду к элементу, а не к браузеру. По умолчанию: _false_.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+// вывести время паузы в мс перед самой паузой и вернуть потом это значение
+await browser.overwriteCommand("pause", function (origPauseFunction, ms) {
+    console.log(`Sleeping for ${ms}`);
+
+    origPauseFunction(ms);
+
+    return ms;
+});
+
+// используем переопределенную команду паузы
+it("should use my overwrite command", async ({ browser }) => {
+    await browser.url("https://webdriver.io");
+
+    await browser.pause(1000); // выведет: "Sleeping for 1000"
+});
+```
+
+## Связанные команды {#related}
+
+-   [addCommand](./addCommand)
+
+[how-to-add-custom-commands]: https://webdriver.io/docs/customcommands/#adding-custom-commands
diff --git a/docs/commands/browser/pause.mdx b/docs/commands/browser/pause.mdx
new file mode 100644
index 0000000..710eee0
--- /dev/null
+++ b/docs/commands/browser/pause.mdx
@@ -0,0 +1,45 @@
+import Admonition from "@theme/Admonition";
+
+# pause
+
+## Обзор {#overview}
+
+Используйте команду `pause`, чтобы приостановить выполнение теста на заданный промежуток времени.
+
+<Admonition type="warning">
+    Не рекомендуется использовать эту команду для ожидания отображения элемента. Чтобы избежать
+    ложных результатов тестирования, лучше использовать такие команды, как
+    [waitForExist][wait-for-exist] или другие команды _waitFor*_.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.pause(milliseconds);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>milliseconds</td><td>Number</td><td>Время в миллисекундах.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should pause the execution", async ({ browser }) => {
+    const starttime = new Date().getTime();
+    await browser.pause(3000);
+    const endtime = new Date().getTime();
+
+    console.log(endtime - starttime); // выведет: 3000
+});
+```
+
+[wait-for-exist]: ../element/waitForExist
diff --git a/docs/commands/browser/reactDollar.mdx b/docs/commands/browser/reactDollar.mdx
new file mode 100644
index 0000000..05d9410
--- /dev/null
+++ b/docs/commands/browser/reactDollar.mdx
@@ -0,0 +1,76 @@
+import Admonition from "@theme/Admonition";
+
+# react$
+
+## Обзор {#overview}
+
+Используйте команду `react$`, чтобы найти на странице React-компоненты по их настоящему имени, одновременно фильтруя их по props'ам и состоянию.
+
+<Admonition type="warning">
+Команда _react$_ работает только в приложениях, которые используют _React v16.x._
+
+Читайте больше о React-селекторах в рецепте «[Как использовать селекторы][how-to-use-selectors]».
+
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.react$(reactComponentSelector, { props, state });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>reactComponentSelector</td><td>String</td><td>Селектор React-компонента.</td></tr>
+<tr><td>props</td><td>Object</td><td>React-свойства, которые должен иметь компонент.</td></tr>
+<tr><td>state</td><td>Any или Any[]</td><td>React-состояние, в котором должен находиться компонент.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should calculate 7 * 6", async ({ browser }) => {
+    await browser.url("https://ahfarmer.github.io/calculator/");
+
+    await browser
+        .react$("t", {
+            props: { name: "7" },
+        })
+        .click();
+
+    await browser
+        .react$("t", {
+            props: { name: "x" },
+        })
+        .click();
+
+    await browser
+        .react$("t", {
+            props: { name: "6" },
+        })
+        .click();
+
+    await browser
+        .react$("t", {
+            props: { name: "=" },
+        })
+        .click();
+
+    console.log(await browser.$(".component-display").getText()); // выведет: "42"
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.react$$](./reactDollarDollar)
+-   [element.react$](../element/reactDollar)
+-   [element.react$$](../element/reactDollarDollar)
+
+[how-to-use-selectors]: https://webdriver.io/docs/selectors
diff --git a/docs/commands/browser/reactDollarDollar.mdx b/docs/commands/browser/reactDollarDollar.mdx
new file mode 100644
index 0000000..5d94520
--- /dev/null
+++ b/docs/commands/browser/reactDollarDollar.mdx
@@ -0,0 +1,57 @@
+import Admonition from "@theme/Admonition";
+
+# react$$
+
+## Обзор {#overview}
+
+Используйте команду `react$$`, чтобы найти на странице множество React-компонентов по их настоящему имени, одновременно фильтруя их по props'ам и состоянию.
+
+<Admonition type="warning">
+Команда _react$_ работает только в приложениях, которые используют _React v16.x._
+
+Читайте больше о React-селекторах в рецепте «[Как использовать селекторы][how-to-use-selectors]».
+
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.react$$(reactComponentSelector, { props, state });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>reactComponentSelector</td><td>String</td><td>Селектор React-компонента.</td></tr>
+<tr><td>props</td><td>Object</td><td>React-свойства, которые должен иметь компонент.</td></tr>
+<tr><td>state</td><td>Any или Any[]</td><td>React-состояние, в котором должен находиться компонент.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should calculate 7 * 6", async ({ browser }) => {
+    await browser.url("https://ahfarmer.github.io/calculator/");
+
+    const orangeButtons = await browser.react$$("t", {
+        props: { orange: true },
+    });
+
+    console.log(await Promise.all(orangeButtons.map(btn => btn.getText())));
+    // выведет: "[ '÷', 'x', '-', '+', '=' ]"
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.react$](./reactDollar)
+-   [element.react$](../element/reactDollar)
+-   [element.react$$](../element/reactDollarDollar)
+
+[how-to-use-selectors]: https://webdriver.io/docs/selectors
diff --git a/docs/commands/browser/reloadSession.mdx b/docs/commands/browser/reloadSession.mdx
new file mode 100644
index 0000000..4b1e2ef
--- /dev/null
+++ b/docs/commands/browser/reloadSession.mdx
@@ -0,0 +1,25 @@
+# reloadSession
+
+## Обзор {#overview}
+
+Используйте команду `reloadSession`, чтобы создать новую Selenium-сессию с текущими _capabilities_.
+
+Эта команда может пригодиться, если вы тестируете приложение с большим количеством состояний, и вам нужно очистить сессию браузера между отдельными тестами в одном файле, чтобы избежать создания сотен отдельных тестовых файлов с помощью WDIO. Однако будьте осторожны, эта команда сильно влияет на время тестирования, поскольку создание новых сессий Selenium отнимает много времени, особенно при использовании облачных сервисов.
+
+## Использование {#usage}
+
+```javascript
+await browser.reloadSession();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it("should reload my session with current capabilities", async ({ browser }) => {
+    console.log(browser.sessionId); // выведет: e042b3f3cd5a479da4e171825e96e655
+
+    await browser.reloadSession();
+
+    console.log(browser.sessionId); // выведет: 9a0d9bf9d4864160aa982c50cf18a573
+});
+```
diff --git a/docs/commands/browser/savePDF.mdx b/docs/commands/browser/savePDF.mdx
new file mode 100644
index 0000000..8a5e619
--- /dev/null
+++ b/docs/commands/browser/savePDF.mdx
@@ -0,0 +1,59 @@
+# savePDF
+
+## Обзор {#overview}
+
+Используйте команду `savePDF`, чтобы сохранить в pdf-файл текущий контекст в браузере.
+
+## Использование {#usage}
+
+```javascript
+await browser.savePDF(filepath, {
+    orientation,
+    scale,
+    background,
+    width,
+    height,
+    top,
+    bottom,
+    left,
+    right,
+    shrinkToFit,
+    pageRanges,
+});
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>filepath</td><td>String</td><td>Путь к pdf-файлу относительно каталога выполнения (расширение _.pdf_ — обязательно).</td></tr>
+<tr><td>orientation</td><td>String</td><td>Ориентация pdf-страницы.</td></tr>
+<tr><td>scale</td><td>Number</td><td>Масштаб pdf-страницы.</td></tr>
+<tr><td>background</td><td>Boolean</td><td>Включить фон pdf-страницы.</td></tr>
+<tr><td>width</td><td>Number</td><td>Ширина pdf-страницы.</td></tr>
+<tr><td>height</td><td>Number</td><td>Высота pdf-страницы.</td></tr>
+<tr><td>top</td><td>Number</td><td>Верхний отступ pdf-страницы.</td></tr>
+<tr><td>bottom</td><td>Number</td><td>Нижний отступ pdf-страницы.</td></tr>
+<tr><td>left</td><td>Number</td><td>Левый отступ pdf-страницы.</td></tr>
+<tr><td>right</td><td>Number</td><td>Правый отступ pdf-страницы.</td></tr>
+<tr><td>shrinkToFit</td><td>Number</td><td>Уменьшить страницу, чтобы она соответствовала размеру pdf-страницы.</td></tr>
+<tr><td>pageRanges</td><td>Object[]</td><td>Диапазон страниц для включения в PDF.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should save a PDF screenshot of the browser view", async ({ browser }) => {
+    await browser.savePDF("./some/path/screenshot.pdf");
+});
+```
+
+## Связанные команды {#related}
+
+-   [saveRecordingScreen](./saveRecordingScreen)
+-   [saveScreenshot](./saveScreenshot)
diff --git a/docs/commands/browser/saveRecordingScreen.mdx b/docs/commands/browser/saveRecordingScreen.mdx
new file mode 100644
index 0000000..43af9ac
--- /dev/null
+++ b/docs/commands/browser/saveRecordingScreen.mdx
@@ -0,0 +1,48 @@
+import Admonition from "@theme/Admonition";
+
+# saveRecordingScreen
+
+## Обзор {#overview}
+
+Используйте команду `saveRecordingScreen`, чтобы сохранить в файл видео, съемка которого была начата командой [startRecordingScreen][start-recording-screen].
+
+<Admonition type="warning">
+    Команда _saveRecordingScreen_ поддерживается только для мобильных сессий, которые используют
+    [Appium][appium].
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.saveRecordingScreen(filepath);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>filepath</td><td>String</td><td>Полный или относительный к исполняемому каталогу путь к видео.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should save a video", async ({ browser }) => {
+    await browser.startRecordingScreen();
+    await browser.$("~BUTTON").click();
+    await browser.saveRecordingScreen("./some/path/video.mp4");
+});
+```
+
+## Связанные команды {#related}
+
+-   [savePDF](./savePDF)
+-   [saveScreenshot](./saveScreenshot)
+
+[start-recording-screen]: https://webdriver.io/docs/api/appium/#startrecordingscreen
+[appium]: http://appium.io/docs/en/commands/device/recording-screen/start-recording-screen/
diff --git a/docs/commands/browser/saveScreenshot.mdx b/docs/commands/browser/saveScreenshot.mdx
new file mode 100644
index 0000000..8b992ad
--- /dev/null
+++ b/docs/commands/browser/saveScreenshot.mdx
@@ -0,0 +1,42 @@
+# saveScreenshot
+
+## Обзор {#overview}
+
+Используйте команду `saveScreenshot`, чтобы сохранить скриншот текущего контекста в браузере в png-файл.
+
+Имейте в виду, что некоторые драйверы браузеров делают скриншоты всего документа (например, драйвер [Gecko][gecko] для Firefox), тогда как другие — только текущего окна просмотра (например, [Chromedriver][chromedriver] для Chrome).
+
+## Использование {#usage}
+
+```javascript
+await browser.saveScreenshot(filepath);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>filepath</td><td>String</td><td>Путь к скриншоту относительно каталога выполнения (расширение _.png_ — обязательно).</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should save a screenshot of the browser view", async ({ browser }) => {
+    await browser.saveScreenshot("./some/path/screenshot.png");
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.savePDF](./savePDF)
+-   [browser.saveRecordingScreen](./saveRecordingScreen)
+-   [element.saveScreenshot](../element/saveScreenshot)
+
+[gecko]: https://github.com/mozilla/geckodriver
+[chromedriver]: https://chromedriver.chromium.org/
diff --git a/docs/commands/browser/scroll.mdx b/docs/commands/browser/scroll.mdx
new file mode 100644
index 0000000..15f61a7
--- /dev/null
+++ b/docs/commands/browser/scroll.mdx
@@ -0,0 +1,40 @@
+# scroll
+
+## Обзор {#overview}
+
+Используйте команду `scroll`, чтобы проскроллить вьюпорт браузера. Обратите внимание, что координаты `x` и `y` относятся к текущей позиции прокрутки вьюпорта.
+
+## Использование {#usage}
+
+```typescript
+await browser.scroll(x, y);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>x</td><td>Number</td><td>Необязательный параметр. Координата x, куда нужно проскроллить. По умолчанию: _0_.</td></tr>
+<tr><td>y</td><td>Number</td><td>Необязательный параметр. Координата y, куда нужно проскроллить. По умолчанию: _0_.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```typescript
+it("should demonstrate the scroll command", async ({ browser }) => {
+    await browser.url("https://webdriver.io");
+
+    console.log(await browser.execute(() => window.scrollY)); // returns 0
+    await browser.scroll(0, 200);
+    console.log(await browser.execute(() => window.scrollY)); // returns 200
+});
+```
+
+## Связанные команды {#related}
+
+-   [element.scrollIntoView](../element/scrollIntoView)
diff --git a/docs/commands/browser/setCookies.mdx b/docs/commands/browser/setCookies.mdx
new file mode 100644
index 0000000..733d377
--- /dev/null
+++ b/docs/commands/browser/setCookies.mdx
@@ -0,0 +1,93 @@
+# setCookies
+
+## Обзор {#overview}
+
+Используйте команду `setCookies`, чтобы установить _cookies_ на текущей странице.
+
+Убедитесь, что вы находитесь именно на той странице, для которой вы хотите установить _cookies_. Вы не можете установить _cookies_ для произвольной страницы, не находясь при этом на ней.
+
+## Использование {#usage}
+
+```javascript
+await browser.setCookies(cookies);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>cookies</td><td>WebDriver.Cookie или WebDriver.Cookie[]</td><td>Объект _cookie_ или массив объектов _cookie_.</td></tr>
+
+</tbody>
+</table>
+
+### Параметры объекта WebDriver.Cookie
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**По умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>name</td><td>String</td><td>_N/A_</td><td>Имя _cookie_.</td></tr>
+<tr><td>value</td><td>String</td><td>_N/A_</td><td>Значение _cookie_.</td></tr>
+<tr><td>path</td><td>String</td><td>"/"</td><td>Путь к _cookie_.</td></tr>
+<tr><td>domain</td><td>String</td><td>_см. описание_</td><td>Домен, для которого будет видна _cookie_. Если домен не указан, то подразумевается домен урла активного документа в текущем контексте браузера.</td></tr>
+<tr><td>secure</td><td>Boolean</td><td>false</td><td>Признак безопасной _cookie_.</td></tr>
+<tr><td>httpOnly</td><td>Boolean</td><td>false</td><td>Признак _cookie_ только для _http_.</td></tr>
+<tr><td>expiry</td><td>Number</td><td>_не устанавливается_</td><td>Срок годности _cookie_ в секундах от начала эпохи Unix.</td></tr>
+<tr><td>sameSite</td><td>String</td><td>"None"</td><td>Признак подчинения _cookie_ политике [SameSite][same-site]. Допустимые значения: _"Lax"_ или _"Strict"_.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should set a cookie for the page", async ({ browser }) => {
+    await browser.url("/");
+
+    // устанавливаем одну cookie
+    await browser.setCookies({
+        name: "test1",
+        value: "one",
+        // Следующие параметры опциональны:
+        // путь к cookie, по умолчанию: "/"
+        //      path: '/foo',
+        // домен, для которого будет видна cookie
+        // по умолчанию: домен урла активного документа в текущем контексте браузера
+        //      domain: '.example.com',
+        // признак, что это безопасная cookie, по умолчанию: false
+        //      secure: true,
+        // признак, что это cookie только для http, по умолчанию: false
+        //      httpOnly: true,
+        // срок, когда cookie истекает, указывается в секундах с начала эпохи Unix
+        //      expiry: 1551393875
+    });
+
+    // устанавливаем несколько cookies
+    await browser.setCookies([
+        { name: "test2", value: "two" },
+        { name: "test3", value: "three" },
+    ]);
+
+    const cookies = await browser.getCookies();
+
+    await console.log(cookies);
+    // выведет:
+    // [
+    //      { name: 'test1', value: 'one', domain: 'www.example.com' },
+    //      { name: 'test2', value: 'two', domain: 'www.example.com' },
+    //      { name: 'test3', value: 'three', domain: 'www.example.com' }
+    // ]
+});
+```
+
+## Связанные команды {#related}
+
+-   [getCookies](./getCookies)
+-   [deleteCookies](./deleteCookies)
+
+[same-site]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie/SameSite
diff --git a/docs/commands/browser/setMeta.mdx b/docs/commands/browser/setMeta.mdx
new file mode 100644
index 0000000..b682244
--- /dev/null
+++ b/docs/commands/browser/setMeta.mdx
@@ -0,0 +1,56 @@
+import Admonition from "@theme/Admonition";
+
+# setMeta
+
+## Обзор
+
+Используйте команду `setMeta`, чтобы записать значение под заданным ключом в мета-информацию теста.
+
+Для чтения мета-информации используйте команду [getMeta](./getMeta).
+
+<Admonition type="info">
+    Эта команда реализована внутри testplane, в [API WebDriverIO][webdriverio-api] её нет.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.setMeta(key, value);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>key</td><td>String</td><td>Ключ, значение для которого нужно записать в мета-информацию теста.</td></tr>
+<tr><td>value</td><td>String</td><td>Значение, которое нужно сохранить в мета-информации теста.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should get meta info of test", async ({ browser }) => {
+    await browser.setMeta("foo", "bar");
+    await browser.url("/foo/bar?baz=qux");
+
+    const val = await browser.getMeta("foo");
+    console.log(val); // выведет: bar
+
+    const url = await browser.getMeta("url");
+    console.log(url); // выведет: /foo/bar?baz=qux
+
+    const meta = await browser.getMeta();
+    console.log(meta); // выведет: {foo: 'bar', url: '/foo/bar?baz=qux'}
+});
+```
+
+## Связанные команды {#related}
+
+-   [getMeta](./getMeta)
+
+[webdriverio-api]: https://webdriver.io/docs/api
diff --git a/docs/commands/browser/setTimeout.mdx b/docs/commands/browser/setTimeout.mdx
new file mode 100644
index 0000000..264e967
--- /dev/null
+++ b/docs/commands/browser/setTimeout.mdx
@@ -0,0 +1,45 @@
+# setTimeout
+
+## Обзор {#overview}
+
+Используйте команду `setTimeout`, чтобы настроить таймауты для поиска элемента на странице, ожидания загрузки документа и выполнения скриптов через команды [execute][execute] или [executeAsync][execute-async].
+
+## Использование {#usage}
+
+```javascript
+await browser.setTimeout({ implicit, pageLoad, script });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>implicit</td><td>Number</td><td>Время в миллисекундах для повторной попытки определения местоположения элемента при поиске элемента.</td></tr>
+<tr><td>pageLoad</td><td>Number</td><td>Время ожидания загрузки документа, в миллисекундах.</td></tr>
+<tr><td>script</td><td>Number</td><td>Таймаут для скриптов, запущенных с помощью [execute][execute] или [executeAsync][execute-async]. Задается в миллисекундах.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should change timeout duration for session with long code duration", async ({ browser }) => {
+    await browser.setTimeout({
+        pageLoad: 10000,
+        script: 60000,
+    });
+
+    // выполняем код, который занимает длительное время
+    await browser.executeAsync(done => {
+        console.log("Wake me up before you go!");
+        setTimeout(done, 59000);
+    });
+});
+```
+
+[execute]: ./execute
+[execute-async]: ./executeAsync
diff --git a/docs/commands/browser/setWindowSize.mdx b/docs/commands/browser/setWindowSize.mdx
new file mode 100644
index 0000000..799da69
--- /dev/null
+++ b/docs/commands/browser/setWindowSize.mdx
@@ -0,0 +1,28 @@
+# setWindowSize
+
+## Обзор {#overview}
+
+Используйте команду `setWindowSize`, чтобы изменить внешний размер окна браузера в соответствии с заданными шириной и высотой.
+
+## Использование {#usage}
+
+```javascript
+await browser.setWindowSize(width, height);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>width</td><td>Number</td><td>Ширина окна браузера, которую нужно установить.</td></tr>
+<tr><td>height</td><td>Number</td><td>Высота окна браузера, которую нужно установить.</td></tr>
+
+</tbody>
+</table>
+
+## Связанные команды {#related}
+
+-   [getWindowSize](./getWindowSize)
diff --git a/docs/commands/browser/switchWindow.mdx b/docs/commands/browser/switchWindow.mdx
new file mode 100644
index 0000000..b7375e7
--- /dev/null
+++ b/docs/commands/browser/switchWindow.mdx
@@ -0,0 +1,41 @@
+# switchWindow
+
+## Обзор {#overview}
+
+Используйте команду `switchWindow`, чтобы перевести фокус на конкретную вкладку или конкретное окно.
+
+## Использование {#usage}
+
+```javascript
+await browser.switchWindow(urlOrTitleToMatch);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>urlOrTitleToMatch</td><td>String или RegExp</td><td>Строка или регулярное выражение, соответствующее заголовку или URL-адресу страницы.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should switch to another window", async ({ browser }) => {
+    // открываем url
+    await browser.url("https://google.com");
+
+    // создаем новое окно
+    await browser.newWindow("https://webdriver.io");
+
+    // переключаемся назад через соответствие заданному урлу
+    await browser.switchWindow("google.com");
+
+    // снова переключаемся через соответствие заданному заголовку страницы
+    await browser.switchWindow("Next-gen browser and mobile automation test framework for Node.js");
+});
+```
diff --git a/docs/commands/browser/throttle.mdx b/docs/commands/browser/throttle.mdx
new file mode 100644
index 0000000..194cbca
--- /dev/null
+++ b/docs/commands/browser/throttle.mdx
@@ -0,0 +1,69 @@
+import Admonition from "@theme/Admonition";
+
+# throttle
+
+## Обзор {#overview}
+
+Используйте команду `throttle`, чтобы эмулировать разные типы сетевого соединения у пользователя.
+
+Эта команда позволяет промоделировать поведение сайта или веб-приложения при различной пропускной способности канала связи у пользователя.
+
+Существует также множество пресетов с готовыми настройками конфигурации сети. Например:
+
+-   offline | online
+-   GPRS
+-   Regular2G | Good2G
+-   Regular3G | Good3G
+-   Regular4G
+-   DSL
+-   WiFi
+
+<Admonition type="warning">
+Команда _throttle_ работает только при использовании _Chrome DevTools Protocol (CDP)_.
+
+Читайте подробности в разделе «[Как использовать Chrome DevTools Protocol в testplane][how-to-use-cdp]».
+
+А также читайте рецепт «[Как управлять пропускной способностью сети][how-to-manage-network-bandwidth]».
+
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.throttle({ offline, latency, downloadThroughput, uploadThroughput });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>offline</td><td>Boolean</td><td>Включить эмуляцию потери соединения.</td></tr>
+<tr><td>latency</td><td>Number</td><td>Минимальная задержка от отправленного запроса до полученных заголовков ответа, в миллисекундах.</td></tr>
+<tr><td>downloadThroughput</td><td>Number</td><td>Максимальная совокупная пропускная способность загрузки (байт/сек). _-1_ отключает регулирование загрузки.</td></tr>
+<tr><td>uploadThroughput</td><td>Number</td><td>Максимальная совокупная пропускная способность аплоада (байт/сек). _-1_ отключает регулирование аплоада.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should throttle the network", async ({ browser }) => {
+    // используем готовый пресет
+    await browser.throttle("Regular 3G");
+
+    // а здесь настраиваем конфигурацию сети сами
+    await browser.throttle({
+        offline: false,
+        downloadThroughput: (200 * 1024) / 8,
+        uploadThroughput: (200 * 1024) / 8,
+        latency: 20,
+    });
+});
+```
+
+[how-to-use-cdp]: ../../guides/how-to-use-cdp
+[how-to-manage-network-bandwidth]: ../../guides/how-to-manage-network-bandwidth
diff --git a/docs/commands/browser/touchAction.mdx b/docs/commands/browser/touchAction.mdx
new file mode 100644
index 0000000..677fd7a
--- /dev/null
+++ b/docs/commands/browser/touchAction.mdx
@@ -0,0 +1,86 @@
+import Admonition from "@theme/Admonition";
+
+# touchAction
+
+## Обзор {#overview}
+
+Используйте команду `touchAction`, чтобы выполнить жесты в тестах на мобильной платформе.
+
+Команда позволяет связывать воедино отдельные действия _[ad hoc][ad-hoc]_, которые затем будут применены к элементу приложения на устройстве.
+
+Основные действия, которые можно использовать:
+
+-   **press** — нужно указать element или координаты (x, y), или и то, и другое
+-   **longPress** — нужно указать element или координаты (x, y), или и то, и другое
+-   **tap** — нужно указать element или координаты (x, y), или и то, и другое
+-   **moveTo** — нужно указать абсолютные координаты (x, y)
+-   **wait** — нужно указать время в миллисекундах
+-   **release** — ничего указывать не нужно
+
+<Admonition type="warning">
+    В настоящее время команда _touchAction_ доступна только для нативных приложений и не может
+    использоваться для взаимодействия с веб-приложениями.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.touchAction(action);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>action</td><td>Object</td><td>Действие, которое надо выполнить.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should do a touch gesture", async ({ browser }) => {
+    const screen = await browser.$("//UITextbox");
+
+    // простой touch action на элементе
+    await browser.touchAction({
+        action: "tap",
+        element: screen,
+    });
+
+    // простой touch action с координатами x и y
+    // координаты касания – 30px направо и 20px вниз относительно вьюпорта
+    await browser.touchAction({
+        action: "tap",
+        x: 30,
+        y: 20,
+    });
+
+    // простой touch action с координатами x и y
+    // координаты касания – 30px направо и 20px вниз относительно центра элемента
+    await browser.touchAction({
+        action: "tap",
+        x: 30,
+        y: 20,
+        element: screen,
+    });
+
+    // multi action на элементе
+    // drag&drop из точки (200, 200) вниз на 100px по экрану
+    await browser.touchAction([
+        { action: "press", x: 200, y: 200 },
+        { action: "moveTo", x: 200, y: 300 },
+        "release",
+    ]);
+});
+```
+
+## Связанные команды {#related}
+
+-   [element.touchAction](../element/touchAction)
+
+[ad-hoc]: https://ru.wikipedia.org/wiki/Ad_hoc
diff --git a/docs/commands/browser/uploadFile.mdx b/docs/commands/browser/uploadFile.mdx
new file mode 100644
index 0000000..d103025
--- /dev/null
+++ b/docs/commands/browser/uploadFile.mdx
@@ -0,0 +1,52 @@
+import Admonition from "@theme/Admonition";
+
+# uploadFile
+
+## Обзор {#overview}
+
+Используйте команду `uploadFile`, чтобы загрузить файл на _[Selenium Standalone][selenium-file]_ сервер или в браузер через его драйвер (например, [Chromedriver][chromedriver]).
+
+<Admonition type="warning">
+    Команда _uploadFile_ поддерживается только в том случае, если вы используете [Selenium
+    Grid][selenium-grid] или [Chromedriver][chromedriver]. Это связано с тем, что она использует
+    неофициальную особенность протокола, которая реализована в данный момент только в _Chrome_ и при
+    запуске в [Selenium Grid][selenium-grid].
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.uploadFile(localPath);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>localPath</td><td>String</td><td>Путь к локальному файлу.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+const path = require("path");
+
+it("should upload a file", async ({ browser }) => {
+    await browser.url("https://the-internet.herokuapp.com/upload");
+
+    const filePath = "/path/to/some/file.png";
+    const remoteFilePath = await browser.uploadFile(filePath);
+
+    await browser.$("#file-upload").setValue(remoteFilePath);
+    await browser.$("#file-submit").click();
+});
+```
+
+[selenium-grid]: https://www.selenium.dev/documentation/grid/
+[selenium-file]: https://webdriver.io/docs/api/selenium/#file
+[chromedriver]: https://chromedriver.chromium.org/
diff --git a/docs/commands/browser/url.mdx b/docs/commands/browser/url.mdx
new file mode 100644
index 0000000..e607d2d
--- /dev/null
+++ b/docs/commands/browser/url.mdx
@@ -0,0 +1,59 @@
+# url
+
+## Обзор {#overview}
+
+Используйте команду `url`, чтобы перейти по заданному URL-адресу в браузере.
+
+Если в конфигурации указан [baseUrl][base-url], то он будет добавлен к параметру `url` с помощью метода Node.JS [url.resolve()][url-resolve].
+
+Вызов `browser.url()` с тем же URL-адресом, что и в прошлый раз, вызовет перезагрузку страницы.
+
+## Использование {#usage}
+
+```javascript
+await browser.url(url);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>url</td><td>String</td><td>URL, который надо открыть.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**url.js**
+
+```javascript
+// переходим на URL
+await browser.url("https://webdriver.io");
+
+// получаем url
+console.log(await browser.getUrl()); // выведет: "https://webdriver.io"
+```
+
+**baseUrlResolutions.js**
+
+```javascript
+// Пусть baseUrl = http://example.com/site
+
+// При указании полного URL-адреса итоговый URL будет https://webdriver.io
+await browser.url("https://webdriver.io");
+
+// При указании URL-адреса без начального слэша
+// итоговый URL формируется относительно всего baseUrl: http://example.com/site/relative
+await browser.url("relative");
+
+// При указании URL-адреса с начальным слэшом
+// итоговый URL формируется относительно корня baseUrl: http://example.com/rootRelative
+await browser.url("/rootRelative");
+```
+
+[base-url]: ../../config/browsers#base_url
+[url-resolve]: https://nodejs.org/api/url.html#urlresolvefrom-to
diff --git a/docs/commands/browser/waitUntil.mdx b/docs/commands/browser/waitUntil.mdx
new file mode 100644
index 0000000..672fb66
--- /dev/null
+++ b/docs/commands/browser/waitUntil.mdx
@@ -0,0 +1,57 @@
+# waitUntil
+
+## Обзор {#overview}
+
+Используйте команду `waitUntil`, чтобы дождаться соблюдения определенного условия на странице в браузере.
+
+## Использование {#usage}
+
+```javascript
+await browser.waitUntil(condition, { timeout, timeoutMsg, interval });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>condition</td><td>Function</td><td>_N/A_</td><td>Условие, которое нужно ждать.</td></tr>
+<tr><td>timeout</td><td>Number</td><td>5000</td><td>Таймаут в миллисекундах.</td></tr>
+<tr><td>timeoutMsg</td><td>String</td><td>_N/A_</td><td>Сообщение об ошибке, которое нужно бросить при таймауте.</td></tr>
+<tr><td>interval</td><td>Number</td><td>500</td><td>Интервал в миллисекундах между проверками условия.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**example.html**
+
+```javascript
+<div id="someText">I am some text</div>
+<script>
+    setTimeout(() => {
+        $('#someText').html('I am now different');
+    }, 1000);
+</script>
+```
+
+**waitUntil.js**
+
+```javascript
+it("should wait until text has changed", async ({ browser }) => {
+    await browser.waitUntil(
+        async () => (await browser.$("#someText").getText()) === "I am now different",
+        {
+            timeout: 5000,
+            timeoutMsg: "expected text to be different after 5s",
+        },
+    );
+});
+```
+
+## Связанные команды {#related}
+
+-   [element.waitUntil](../element/waitUntil)
diff --git a/docs/commands/element/$$.mdx b/docs/commands/element/$$.mdx
new file mode 100644
index 0000000..7dba915
--- /dev/null
+++ b/docs/commands/element/$$.mdx
@@ -0,0 +1,89 @@
+import Admonition from "@theme/Admonition";
+
+# $$
+
+## Обзор {#overview}
+
+Используйте команду `$$` вместо [findElements][find-elements] как более краткую команду, чтобы получить несколько элементов на странице в области видимости элемента. Эта команда похожа на команду [browser.$$()](../browser/$$), и отличается только тем, что поиск элементов будет осуществляться среди потомков _(children)_ текущего элемента.
+
+<Admonition type="info">
+    Подробнее о том, как выбрать определенные элементы, смотрите в рецепте «[Как использовать
+    селекторы][how-to-use-selectors]».
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).$$(subSelector);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>subSelector</td><td>String или Function или Matcher</td><td>Селектор, или JS-функция, или Matcher для получения множества элементов.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```html
+<ul id="menu">
+    <li>
+        <a href="/">Home</a>
+    </li>
+    <li>
+        <a href="/">Developer Guide</a>
+    </li>
+    <li>
+        <a href="/">API</a>
+    </li>
+    <li>
+        <a href="/">Contribute</a>
+    </li>
+</ul>
+```
+
+**$$.js**
+
+```javascript
+it("should get text a menu link", async ({ browser }) => {
+    const text = await browser.$("#menu");
+
+    console.log(await text.$$("li")[2].$("a").getText()); // выведет: "API"
+});
+
+it("should get text a menu link - JS Function", async ({ browser }) => {
+    const text = await browser.$("#menu");
+
+    console.log(
+        await text
+            .$$(function () {
+                // Использовать здесь стрелочную функцию нельзя.
+                // Это Element – https://developer.mozilla.org/en-US/docs/Web/API/Element
+                // в этом конкретном примере – это HTMLUListElement
+                //
+                // TypeScript-пользователи могут сделать что-нибудь вроде:
+                // return (this as Element).querySelector('li')
+                return this.querySelectorAll("li"); // Element[]
+            })[2]
+            .$("a")
+            .getText(),
+    ); // выведет: "API"
+});
+```
+
+## Связанные команды
+
+-   [element.$](./$)
+-   [browser.$](../browser/$)
+-   [browser.$$](../browser/$$)
+
+[find-elements]: https://webdriver.io/docs/api/webdriver/#findelements
+[how-to-use-selectors]: https://webdriver.io/docs/selectors
diff --git a/docs/commands/element/$.mdx b/docs/commands/element/$.mdx
new file mode 100644
index 0000000..0e0a087
--- /dev/null
+++ b/docs/commands/element/$.mdx
@@ -0,0 +1,118 @@
+---
+sidebar_position: 1
+---
+
+import Admonition from "@theme/Admonition";
+
+# $
+
+## Обзор {#overview}
+
+Используйте команду `$` вместо [findElement][find-element] как более краткую команду, чтобы получить один элемент на странице.
+
+Команда `$` возвращает объект, описывающий элемент, на котором можно вызывать команды действия без передачи селектора. Однако, если вы все же передадите селектор, то сначала будет найден соответствующий элемент, а затем вызвано действие для этого элемента. Вы также можете передать объект в качестве селектора, где объект содержит свойство `element-6066-11e4-a52e-4f735466cecf` со значением ссылки на элемент. Затем команда преобразует ссылку в расширенный элемент WebdriverIO. Примечание: используйте эти объекты элементов только в том случае, если вы уверены, что они существуют на странице. Последнее можно проверить, например, используя команду [isExisting](./isExisting).
+
+Вы можете связать `$` или `$$` вместе, чтобы спуститься по дереву DOM. Но имейте в виду, что объединение команд `$` и `$$` в цепочки имеет смысл только при использовании стратегий с множественными селекторами. Иначе вы будете делать ненужные запросы, которые замедлят тест (например, `$('body').$('div')` создаст два запроса, тогда как `$('body div')` сделает то же самое за один запрос).
+
+<Admonition type="info">
+    Подробнее о том, как выбрать определенные элементы, читайте в рецепте «[Как использовать
+    селекторы][how-to-use-selectors]».
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>selector</td><td>String или Function или Matcher</td><td>Селектор, или JS-функция, или объект Matcher для получения конкретного элемента.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```html
+<ul id="menu">
+    <li>
+        <a href="/">Home</a>
+    </li>
+    <li>
+        <a href="/">Developer Guide</a>
+    </li>
+    <li>
+        <a href="/">API</a>
+    </li>
+    <li>
+        <a href="/">Contribute</a>
+    </li>
+</ul>
+```
+
+```javascript
+it("should get text of a menu link - JS Function", async ({ browser }) => {
+    const text = await browser.$("#menu");
+
+    console.log(
+        await text
+            .$$("li")[2]
+            .$(function () {
+                // Использовать здесь стрелочную функцию нельзя.
+                // Это Element – https://developer.mozilla.org/en-US/docs/Web/API/Element
+                // в этом конкретном примере – это HTMLLIElement
+                //
+                // TypeScript-пользователи могут сделать что-нибудь вроде:
+                // return (this as Element).querySelector('a')
+                return this.querySelector("a"); // Element
+            })
+            .getText(),
+    ); // выведет: "API"
+});
+
+it("should get text a menu link", async ({ browser }) => {
+    const text = await browser.$("#menu");
+
+    console.log(await text.$$("li")[2].$("a").getText()); // выведет: "API"
+});
+
+it("should allow to convert protocol result of an element into a WebdriverIO element", async ({
+    browser,
+}) => {
+    const activeElement = await browser.getActiveElement();
+
+    console.log(await browser.$(activeElement).getTagName()); // выведет активный элемент
+});
+
+it("should use Androids DataMatcher or ViewMatcher selector", async ({ browser }) => {
+    const menuItem = await browser.$({
+        name: "hasEntry",
+        args: ["title", "ViewTitle"],
+        class: "androidx.test.espresso.matcher.ViewMatchers",
+    });
+    await menuItem.click();
+
+    const menuItem = await browser.$({
+        name: "hasEntry",
+        args: ["title", "ViewTitle"],
+    });
+    await menuItem.click();
+});
+```
+
+## Связанные команды {#related}
+
+-   [element.$$](./$$)
+-   [browser.$](../browser/$)
+-   [browser.$$](../browser/$$)
+
+[find-element]: https://webdriver.io/docs/api/webdriver/#findelement
+[how-to-use-selectors]: https://webdriver.io/docs/selectors
diff --git a/docs/commands/element/addValue.mdx b/docs/commands/element/addValue.mdx
new file mode 100644
index 0000000..9e518c0
--- /dev/null
+++ b/docs/commands/element/addValue.mdx
@@ -0,0 +1,42 @@
+# addValue
+
+## Обзор {#overview}
+
+Используйте команду `addValue`, чтобы добавить значение в элемент типа `<input>` или `<textarea>`.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).addValue(value);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>value</td><td>String или Number</td><td>Значение, которое необходимо добавить.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should demonstrate the addValue command", async ({ browser }) => {
+    let input = await browser.$(".input");
+    await input.addValue("test");
+    await input.addValue(123);
+
+    value = await input.getValue();
+    assert.equal(value, "test123"); // true
+});
+```
+
+## Связанные команды {#related}
+
+-   [element.clearValue](./clearValue)
+-   [element.setValue](./setValue)
+-   [browser.keys](../browser/keys)
diff --git a/docs/commands/element/assertView.mdx b/docs/commands/element/assertView.mdx
new file mode 100644
index 0000000..e0c35fa
--- /dev/null
+++ b/docs/commands/element/assertView.mdx
@@ -0,0 +1,90 @@
+import Admonition from "@theme/Admonition";
+
+# assertView
+
+## Обзор {#overview}
+
+Используйте команду `assertView`, чтобы снять скриншот элемента для определенного состояния теста и сравнить его с эталонным.
+
+<Admonition type="info">
+    Эта команда реализована внутри testplane, в [API WebDriverIO][webdriverio-api] её нет.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).assertView(state, options);
+```
+
+<Admonition type="warning">
+    Во время выполнения команда _assertView_ вызывает [waitForExist][wait-for-exist] с
+    [waitTimeout][wait-timeout] и [waitInterval][wait-interval].
+</Admonition>
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[state](#state)</td><td>String</td><td>Обязательный параметр. Название состояния теста. Должно быть уникальным в пределах одного теста.</td></tr>
+<tr><td>[options](#options)</td><td>Object</td><td>Настройки команды _assertView_.</td></tr>
+
+</tbody>
+</table>
+
+### state
+
+Обязательный параметр. Задает название состояния теста. Название должно быть уникальным в пределах одного теста.
+
+### options
+
+Задает настройки команды `assertView`:
+
+<table>
+<thead>
+<tr><td>**Опция**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>ignoreElements</td><td>Array или String</td><td>Элементы (задаются как селекторы), которые будут проигнорированы при сравнении скриншотов. Игнор реализуется с помощью закраски перечисленных элементов черным цветом. В случае одного элемента параметр можно задавать как строку.</td></tr>
+<tr><td>tolerance</td><td>Number</td><td>Чувствительность к разнице в цветам. Значение перетирает [browsers.tolerance][browsers-tolerance].</td></tr>
+<tr><td>antialiasingTolerance</td><td>Number</td><td>Чувствительность в антиалиасинге. Значение перетирает [browsers.antialiasingTolerance][browsers-antialiasing-tolerance].</td></tr>
+<tr><td>allowViewportOverflow</td><td>Boolean</td><td>По умолчанию testplane выдает ошибку, если элемент находится за пределами границ вьюпорта. Этот параметр отключает проверку на границы, позволяя снимать скриншоты элементов, не влезающих во вьюпорт. При этом на скриншоте будут видны только те части элемента, которые влезли во вьюпорт. Однако если _compositeImage_ равен _true_, то части элемента, которые оказались за _нижней_ границей вьюпорта, тоже будут видны на скриншоте. Аналогично если _captureElementFromTop_ равен _true_, то на скриншот попадут и те части элемента, которые оказались за пределами _верхней_ границы вьюпорта.</td></tr>
+<tr><td>captureElementFromTop</td><td>Boolean</td><td>Снимать скриншот элемента с самого верха. Если элемент находится за пределами вьюпорта, то к нему будет выполнен подскролл.</td></tr>
+<tr><td>compositeImage</td><td>Boolean</td><td>Позволяет тестировать элементы, не влезающие во вьюпорт по высоте.</td></tr>
+<tr><td>screenshotDelay</td><td>Number</td><td>Задержка в миллисекундах перед снятием скриншота. Может пригодиться, когда на странице есть элементы, использующие анимацию, или скроллбар, который исчезает не сразу и попадает на результирующий скриншот.</td></tr>
+<tr><td>selectorToScroll</td><td>String</td><td>Селектор, который нужно скроллировать. Может пригодиться, когда надо сделать скриншот модального окна, которое не помещается на экране. Иначе без указания селектора скролл будет применяться к объекту _window_, и скроллироваться будет задний фон, оставляя попап-окно на месте.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**example.js**
+
+```javascript
+it("should assert view", async ({ browser }) => {
+    await browser.url("some/url");
+
+    const elem = await browser.$(".button");
+
+    await elem.assertView("plain");
+    await elem.click();
+    await elem.assertView("clicked");
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.assertView](../browser/assertView)
+-   [browser.saveRecordingScreen](../browser/saveRecordingScreen)
+-   [browser.saveScreenshot](../browser/saveScreenshot)
+-   [element.saveScreenshot](./saveScreenshot)
+
+[webdriverio-api]: https://webdriver.io/docs/api
+[wait-for-exist]: ./waitForExist
+[wait-timeout]: ../../config/browsers#wait_timeout
+[wait-interval]: ../../config/browsers#wait_interval
+[browsers-tolerance]: ../../config/browsers#tolerance
+[browsers-antialiasing-tolerance]: ../../config/browsers#antialiasing_tolerance
diff --git a/docs/commands/element/clearValue.mdx b/docs/commands/element/clearValue.mdx
new file mode 100644
index 0000000..eb9d6e3
--- /dev/null
+++ b/docs/commands/element/clearValue.mdx
@@ -0,0 +1,42 @@
+import Admonition from "@theme/Admonition";
+
+# clearValue
+
+## Обзор {#overview}
+
+Используйте команду `clearValue`, чтобы очистить значение элемента типа `<input>` или `<textarea>`.
+
+<Admonition type="warning">
+Убедитесь, что вы можете взаимодействовать с элементом, прежде чем применять данную команду.
+
+Вы не сможете очистить значение элемента, который отключен или находится в режиме «только для чтения» _(readonly)_.
+
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).clearValue();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it("should demonstrate the clearValue command", async ({ browser }) => {
+    const elem = await browser.$(".input");
+    await elem.setValue("test123");
+
+    const value = await elem.getValue();
+    console.log(value); // выведет: 'test123'
+
+    await elem.clearValue();
+    value = await elem.getValue();
+    assert.equal(value, ""); // true
+});
+```
+
+## Связанные команды {#related}
+
+-   [element.addValue](./addValue)
+-   [element.setValue](./setValue)
+-   [browser.keys](../browser/keys)
diff --git a/docs/commands/element/click.mdx b/docs/commands/element/click.mdx
new file mode 100644
index 0000000..2969b83
--- /dev/null
+++ b/docs/commands/element/click.mdx
@@ -0,0 +1,135 @@
+import Admonition from "@theme/Admonition";
+
+# click
+
+## Обзор {#overview}
+
+Используйте команду `click`, чтобы кликнуть по элементу.
+
+<Admonition type="warning">
+Если у вас есть элементы с фиксированным положением (например, фиксированный _header_ или _footer)_, которые закрывают выбранный элемент после подскролла к нему, то клик будет произведен в заданных координатах, но будет получен вашим фиксированным (накладывающимся) элементом. В этих случаях выдается следующая ошибка:
+
+_Element is not clickable at point (x, x). Other element would receive the click: ..._
+
+Чтобы обойти это, попробуйте найти накладывающийся элемент и удалить его с помощью команды [execute][execute], чтобы он не мешал клику. Вы также можете попробовать проскроллить элемент самостоятельно, используя скролл со смещением, соответствующим вашему сценарию.
+
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).click({ button, x, y, skipRelease });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>button</td><td>String или Number</td><td>Кнопка, с помощью которой нужно выполнить клик. Может принимать значения _0, 1, 2_ или _"left", "middle", "right"_ соответственно.</td></tr>
+<tr><td>x</td><td>Number</td><td>Координата x, куда нужно кликнуть.</td></tr>
+<tr><td>y</td><td>Number</td><td>Координата y, куда нужно кликнуть.</td></tr>
+<tr><td>skipRelease</td><td>Boolean</td><td>Если значение _true_, то после клика не нужно отправлять _releaseActions._</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+### Пример 1
+
+**example-1.html**
+
+```javascript
+<button id="myButton" onclick="document.getElementById('someText').innerHTML='I was clicked'">Click me</button>
+<div id="someText">I was not clicked</div>
+```
+
+**click-1.js**
+
+```javascript
+it("should demonstrate the click command", async ({ browser }) => {
+    const myButton = await browser.$("#myButton");
+    await myButton.click();
+
+    const myText = await browser.$("#someText");
+    const text = await myText.getText();
+
+    assert.equal(text, "I was clicked"); // true
+});
+```
+
+**example-1.js**
+
+```javascript
+it("should fetch menu links and visit each page", async ({ browser }) => {
+    const links = await browser.$$("#menu a");
+
+    for (let link of links) {
+        await link.click();
+    }
+});
+```
+
+### Пример 2
+
+**example-2.html**
+
+```javascript
+<button id="myButton">Click me</button>
+```
+
+**example-2.js**
+
+```javascript
+it("should demonstrate a click using an offset", async ({ browser }) => {
+    const myButton = await browser.$("#myButton");
+
+    // кликаем на расстоянии 30 горизонтальных пикселей
+    // от местоположения кнопки (от центра элемента)
+    await myButton.click({ x: 30 });
+});
+```
+
+### Пример 3
+
+**example-3.html**
+
+```javascript
+<button id="myButton">Click me</button>
+```
+
+**example-3.js**
+
+```javascript
+it("should demonstrate a right click passed as string", async ({ browser }) => {
+    const myButton = await browser.$("#myButton");
+
+    // открываем контекстное меню в месте расположения кнопки
+    await myButton.click({ button: "right" });
+});
+
+it("should demonstrate a right click passed as number while adding an offset", async ({
+    browser,
+}) => {
+    const myButton = await browser.$("#myButton");
+
+    // открываем контекстное меню на расстоянии 30 горизонтальных и 40 вертикальных пикселей
+    // от местоположения кнопки (от центра элемента)
+    await myButton.click({ button: 2, x: 30, y: 40 });
+});
+
+it("should skip sending releaseAction command that cause unexpected alert closure", async ({
+    browser,
+}) => {
+    const myButton = await browser.$("#myButton");
+
+    // пропускаем отправку releaseActions
+    await myButton.click({ button: 2, x: 30, y: 40, skipRelease: true });
+});
+```
+
+[execute]: ../browser/execute
+[webdriver-click]: https://w3c.github.io/webdriver/#dfn-element-click
diff --git a/docs/commands/element/doubleClick.mdx b/docs/commands/element/doubleClick.mdx
new file mode 100644
index 0000000..39e61a1
--- /dev/null
+++ b/docs/commands/element/doubleClick.mdx
@@ -0,0 +1,32 @@
+# doubleClick
+
+## Обзор {#overview}
+
+Используйте команду `doubleClick`, чтобы выполнить двойной клик по элементу.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).doubleClick();
+```
+
+## Примеры использования {#examples}
+
+**example.html**
+
+```javascript
+<button id="myButton" ondblclick="document.getElementById('someText').innerHTML='I was dblclicked'">Click me</button>
+<div id="someText">I was not clicked</div>
+```
+
+**doubleClick.js**
+
+```javascript
+it("should demonstrate the doubleClick command", async ({ browser }) => {
+    const myButton = await browser.$("#myButton");
+    await myButton.doubleClick();
+
+    const value = await myButton.getText();
+    assert.equal(value, "I was dblclicked"); // true
+});
+```
diff --git a/docs/commands/element/dragAndDrop.mdx b/docs/commands/element/dragAndDrop.mdx
new file mode 100644
index 0000000..00a83c5
--- /dev/null
+++ b/docs/commands/element/dragAndDrop.mdx
@@ -0,0 +1,39 @@
+# dragAndDrop
+
+## Обзор {#overview}
+
+Используйте команду `dragAndDrop`, чтобы перетащить элемент в указанный элемент назначения или позицию.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).dragAndDrop(target, { duration });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>target</td><td>Element или DragAndDropCoordinate</td><td>Элемент назначения или объект с координатами _x_ и _y_.</td></tr>
+<tr><td>duration</td><td>Number</td><td>Таймаут для перетаскивания элемента _(операции drag)_.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should demonstrate the dragAndDrop command", async ({ browser }) => {
+    const elem = await browser.$("#someElem");
+    const target = await browser.$("#someTarget");
+
+    // выполнить drag and drop в другой элемент
+    await elem.dragAndDrop(target);
+
+    // выполнить drag and drop относительно текущей позиции
+    await elem.dragAndDrop({ x: 100, y: 200 });
+});
+```
diff --git a/docs/commands/element/getAttribute.mdx b/docs/commands/element/getAttribute.mdx
new file mode 100644
index 0000000..f1fcdb2
--- /dev/null
+++ b/docs/commands/element/getAttribute.mdx
@@ -0,0 +1,45 @@
+# getAttribute
+
+## Обзор {#overview}
+
+Используйте команду `getAttribute`, чтобы получить атрибут из DOM-элемента на основе имени атрибута.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getAttribute(attributeName);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>attributeName</td><td>String</td><td>Имя запрашиваемого атрибута.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<form action="/submit" method="post" class="loginForm">
+    <input type="text" name="name" placeholder="username"></input>
+    <input type="text" name="password" placeholder="password"></input>
+    <input type="submit" name="submit" value="submit"></input>
+</form>
+```
+
+**getAttribute.js**
+
+```javascript
+it("should demonstrate the getAttribute command", async ({ browser }) => {
+    const form = await browser.$("form");
+    const attr = await form.getAttribute("method");
+    console.log(attr); // выведет: "post"
+});
+```
diff --git a/docs/commands/element/getCSSProperty.mdx b/docs/commands/element/getCSSProperty.mdx
new file mode 100644
index 0000000..69d357a
--- /dev/null
+++ b/docs/commands/element/getCSSProperty.mdx
@@ -0,0 +1,102 @@
+import Admonition from "@theme/Admonition";
+
+# getCSSProperty
+
+## Обзор {#overview}
+
+Используйте команду `getCSSProperty`, чтобы получить свойство CSS из DOM-элемента, выбранного заданным селектором.
+
+Возвращаемое значение отформатировано так, чтобы его можно было проверить:
+
+-   цвета преобразуются с помощью [rgb2hex][rgb-to-hex];
+-   все остальные свойства преобразуются с помощью [css-value][css-value].
+
+<Admonition type="warning">
+    Обратите внимание, что сокращенные свойства CSS (например, _background, font, border, margin,
+    padding, list-style, outline, pause, cue)_ будут расширены для извлечения всех «длинных»
+    свойств, что приведет к нескольким вызовам _WebDriver_. Если вас интересует конкретное «длинное»
+    свойство, рекомендуется вместо этого запросить его.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getCSSProperty(cssProperty);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>cssProperty</td><td>String</td><td>Имя свойства CSS.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**example.html**
+
+```javascript
+<label
+    id="myLabel"
+    for="input"
+    style="color: #0088cc; font-family: helvetica, arial, freesans, clean, sans-serif, width: 100px"
+>
+    Some Label
+</label>
+```
+
+**getCSSProperty.js**
+
+```javascript
+it("should demonstrate the getCSSProperty command", async ({ browser }) => {
+    const elem = await browser.$("#myLabel");
+    const color = await elem.getCSSProperty("color");
+    console.log(color);
+    // выведет следующее:
+    // {
+    //     property: 'color',
+    //     value: 'rgba(0, 136, 204, 1)',
+    //     parsed: {
+    //         hex: '#0088cc',
+    //         alpha: 1,
+    //         type: 'color',
+    //         rgba: 'rgba(0, 136, 204, 1)'
+    //     }
+    // }
+
+    const font = await elem.getCSSProperty("font-family");
+    console.log(font);
+    // выведет следующее:
+    // {
+    //      property: 'font-family',
+    //      value: 'helvetica',
+    //      parsed: {
+    //          value: [ 'helvetica', 'arial', 'freesans', 'clean', 'sans-serif' ],
+    //          type: 'font',
+    //          string: 'helvetica, arial, freesans, clean, sans-serif'
+    //      }
+    // }
+
+    var width = await elem.getCSSProperty("width");
+    console.log(width);
+    // выведет следующее:
+    // {
+    //     property: 'width',
+    //     value: '100px',
+    //     parsed: {
+    //         type: 'number',
+    //         string: '100px',
+    //         unit: 'px',
+    //         value: 100
+    //     }
+    // }
+});
+```
+
+[rgb-to-hex]: https://github.com/christian-bromann/rgb2hex
+[css-value]: https://github.com/reworkcss/css-value
diff --git a/docs/commands/element/getComputedLabel.mdx b/docs/commands/element/getComputedLabel.mdx
new file mode 100644
index 0000000..c8572ed
--- /dev/null
+++ b/docs/commands/element/getComputedLabel.mdx
@@ -0,0 +1,23 @@
+# getComputedLabel
+
+## Обзор {#overview}
+
+Используйте команду `getComputedLabel`, чтобы получить вычисленную [WAI-ARIA][wai-aria] метку элемента.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getComputedLabel();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it("should demonstrate the getComputedLabel command", async ({ browser }) => {
+    await browser.url("https://www.google.com/ncr");
+    const elem = await browser.$('*[name="q"]');
+    console.log(await elem.getComputedLabel()); // выведет: "Search"
+});
+```
+
+[wai-aria]: https://ru.wikipedia.org/wiki/WAI-ARIA
diff --git a/docs/commands/element/getComputedRole.mdx b/docs/commands/element/getComputedRole.mdx
new file mode 100644
index 0000000..a1bec1a
--- /dev/null
+++ b/docs/commands/element/getComputedRole.mdx
@@ -0,0 +1,23 @@
+# getComputedRole
+
+## Обзор {#overview}
+
+Используйте команду `getComputedRole`, чтобы получить вычисленную [WAI-ARIA][wai-aria] роль элемента.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getComputedRole();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it("should demonstrate the getComputedRole command", async ({ browser }) => {
+    await browser.url("https://www.google.com/ncr");
+    const elem = await browser.$('*[name="q"]');
+    console.log(await elem.getComputedRole()); // выведет: "combobox"
+});
+```
+
+[wai-aria]: https://ru.wikipedia.org/wiki/WAI-ARIA
diff --git a/docs/commands/element/getHTML.mdx b/docs/commands/element/getHTML.mdx
new file mode 100644
index 0000000..a61a090
--- /dev/null
+++ b/docs/commands/element/getHTML.mdx
@@ -0,0 +1,49 @@
+# getHTML
+
+## Обзор {#overview}
+
+Используйте команду `getHTML`, чтобы получить исходный код указанного элемента DOM.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getHTML(includeSelectorTag);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>includeSelectorTag</td><td>Boolean</td><td>Необязательный параметр. Включить в исходный код тег элемента селектора. По умолчанию: _true_.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div id="test">
+    <span>Lorem ipsum dolor amet</span>
+</div>
+```
+
+**getHTML.js**
+
+```javascript
+it("should get html for certain elements", async ({ browser }) => {
+    var outerHTML = await browser.$("#test").getHTML();
+    console.log(outerHTML);
+    // выведет:
+    // "<div id="test"><span>Lorem ipsum dolor amet</span></div>"
+
+    var innerHTML = await browser.$("#test").getHTML(false);
+    console.log(innerHTML);
+    // выведет:
+    // "<span>Lorem ipsum dolor amet</span>"
+});
+```
diff --git a/docs/commands/element/getLocation.mdx b/docs/commands/element/getLocation.mdx
new file mode 100644
index 0000000..b4439ad
--- /dev/null
+++ b/docs/commands/element/getLocation.mdx
@@ -0,0 +1,42 @@
+# getLocation
+
+## Обзор {#overview}
+
+Используйте команду `getLocation`, чтобы определить местоположение элемента на странице.
+
+Точка `(0, 0)` относится к верхнему левому углу страницы.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getLocation(prop);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>prop</td><td>String</td><td>Необязательный параметр. Может быть "x" или "y", чтобы сразу получить нужное значение для упрощения проверок. Если параметр не указан, команда возвращает объект вида _\{ x, y }_.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should demonstrate the getLocation function", async ({ browser }) => {
+    await browser.url("http://github.com");
+    const logo = await browser.$(".octicon-mark-github");
+    const location = await logo.getLocation();
+    console.log(location); // выведет: { x: 150, y: 20 }
+
+    const xLocation = await logo.getLocation("x");
+    console.log(xLocation); // выведет: 150
+
+    const yLocation = await logo.getLocation("y");
+    console.log(yLocation); // выведет: 20
+});
+```
diff --git a/docs/commands/element/getProperty.mdx b/docs/commands/element/getProperty.mdx
new file mode 100644
index 0000000..d14c618
--- /dev/null
+++ b/docs/commands/element/getProperty.mdx
@@ -0,0 +1,33 @@
+# getProperty
+
+## Обзор {#overview}
+
+Используйте команду `getProperty`, чтобы получить свойство элемента.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getProperty(property);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>property</td><td>String</td><td>Имя свойства элемента.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should demonstrate the getProperty command", async ({ browser }) => {
+    var elem = await browser.$("body");
+    var tag = await elem.getProperty("tagName");
+    console.log(tag); // выведет: "BODY"
+});
+```
diff --git a/docs/commands/element/getSize.mdx b/docs/commands/element/getSize.mdx
new file mode 100644
index 0000000..394085c
--- /dev/null
+++ b/docs/commands/element/getSize.mdx
@@ -0,0 +1,41 @@
+# getSize
+
+## Обзор {#overview}
+
+Используйте команду `getSize`, чтобы получить ширину и высоту DOM-элемента.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getSize(prop);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>prop</td><td>String</td><td>Необязательный параметр. Размер, который нужно получить: "width" или "height". Если параметр не указан, то команда вернет объект вида _\{ width, height }_.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it('should demonstrate the getSize command', async ({ browser }) => {
+    await browser.url('http://github.com');
+    const logo = await browser.$('.octicon-mark-github');
+
+    const size = await logo.getSize();
+    console.log(size); // выведет: { width: 32, height: 32 }
+
+    const width = await logo.getSize('width');
+    console.log(width); // выведет: 32
+
+    const height = await logo.getSize('height';)
+    console.log(height); // выведет: 32
+})
+```
diff --git a/docs/commands/element/getTagName.mdx b/docs/commands/element/getTagName.mdx
new file mode 100644
index 0000000..7425f69
--- /dev/null
+++ b/docs/commands/element/getTagName.mdx
@@ -0,0 +1,29 @@
+# getTagName
+
+## Обзор {#overview}
+
+Используйте команду `getTagName`, чтобы получить имя тега DOM-элемента.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getTagName();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div id="elem">Lorem ipsum</div>
+```
+
+**getTagName.js**
+
+```javascript
+it("should demonstrate the getTagName command", async ({ browser }) => {
+    const tagName = await browser.$("#elem").getTagName();
+
+    console.log(tagName); // выведет: "div"
+});
+```
diff --git a/docs/commands/element/getText.mdx b/docs/commands/element/getText.mdx
new file mode 100644
index 0000000..5ee951e
--- /dev/null
+++ b/docs/commands/element/getText.mdx
@@ -0,0 +1,48 @@
+# getText
+
+## Обзор {#overview}
+
+Используйте команду `getText`, чтобы получить текстовое содержимое из DOM-элемента.
+
+Убедитесь, что элемент, из которого вы хотите запросить текст, является [интерактивным][interactable], иначе команда вернет вам пустую строку. Если элемент отключен _(disabled)_ или не виден _(not visible)_, и вы все еще хотите получить его текстовое содержимое, воспользуйтесь командой [getHTML](./getHTML) в качестве обходного пути.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getText();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div id="elem">
+    Lorem ipsum <strong>dolor</strong> sit amet,<br />
+    consetetur sadipscing elitr
+</div>
+<span style="display: none">I am invisible</span>
+```
+
+**getText.js**
+
+```javascript
+it("should demonstrate the getText function", async ({ browser }) => {
+    console.log(await browser.$("#elem").getText());
+    // выведет: "Lorem ipsum dolor sit amet,consetetur sadipscing elitr"
+
+    console.log(await browser.$("span").getText());
+    // выведет: "" (пустую строку) т. к. элемент – не интерактивный
+});
+
+it("get content from table cell", async ({ browser }) => {
+    await browser.url("http://the-internet.herokuapp.com/tables");
+
+    const rows = await browser.$$("#table1 tr");
+    const columns = await rows[1].$$("td"); // получить столбцы 2-го ряда
+
+    console.log(await columns[2].getText()); // получить текст из 3-го столбца
+});
+```
+
+[interactable]: https://www.w3.org/TR/webdriver/#interactability
diff --git a/docs/commands/element/getValue.mdx b/docs/commands/element/getValue.mdx
new file mode 100644
index 0000000..4ec6c6d
--- /dev/null
+++ b/docs/commands/element/getValue.mdx
@@ -0,0 +1,33 @@
+# getValue
+
+## Обзор {#overview}
+
+Используйте команду `getValue`, чтобы получить значение `<textarea>`, `<select>` или элемента `<input>` типа `text` для указанного селектора.
+
+Если для переданного селектора будет найдено несколько элементов, то команда вернет массив значений.
+
+Для получения значений элементов `<input>` типа `checkbox` или `radio` используйте команду [isSelected](./isSelected).
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).getValue();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<input type="text" value="John Doe" id="username">
+```
+
+**getValue.js**
+
+```javascript
+it("should demonstrate the getValue command", async ({ browser }) => {
+    const value = await browser.$("#username").getValue();
+
+    console.log(value); // выведет: "John Doe"
+});
+```
diff --git a/docs/commands/element/isClickable.mdx b/docs/commands/element/isClickable.mdx
new file mode 100644
index 0000000..f2d7b40
--- /dev/null
+++ b/docs/commands/element/isClickable.mdx
@@ -0,0 +1,45 @@
+import Admonition from "@theme/Admonition";
+
+# isClickable
+
+## Обзор {#overview}
+
+Используйте команду `isClickable`, чтобы определить, можно ли кликнуть по заданному DOM-элементу.
+
+Команда возвращает `true`, если выбранный DOM-элемент:
+
+-   существует
+-   видимый
+-   находится внутри вьюпорта (если нет, то попробуйте сделать подскролл к элементу)
+-   центр элемента не перекрыт другим элементом
+-   элемент не отключен _(not disabled)_
+
+иначе команда возвращает `false`.
+
+<Admonition type="warning">
+Команда _isClickable_ работает только в веб-браузере и в контексте _webview_ мобильных приложений.
+
+Команда не работает в нативном контексте мобильных приложений.
+
+Кроме того, в отличие от других команд элемента, testplane не будет дожидаться существования элемента, чтобы выполнить эту команду.
+
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).isClickable();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it("should detect if an element is clickable", async ({ browser }) => {
+    const el = await browser.$("#el");
+    let clickable = await el.isClickable();
+    console.log(clickable); // выведет: true или false
+
+    // подождем, когда на элемент можно будет кликнуть
+    await browser.waitUntil(() => el.isClickable());
+});
+```
diff --git a/docs/commands/element/isDisplayed.mdx b/docs/commands/element/isDisplayed.mdx
new file mode 100644
index 0000000..0056fc8
--- /dev/null
+++ b/docs/commands/element/isDisplayed.mdx
@@ -0,0 +1,57 @@
+import Admonition from "@theme/Admonition";
+
+# isDisplayed
+
+## Обзор {#overview}
+
+Используйте команду `isDisplayed`, чтобы определить, отображается ли заданный DOM-элемент.
+
+Команда возвращает `true`, если выбранный DOM-элемент отображается, иначе возвращает `false`.
+
+<Admonition type="warning">
+    В отличие от других команд элемента, testplane не будет дожидаться существования элемента, чтобы
+    выполнить эту команду.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).isDisplayed();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div id="notDisplayed" style="display: none"></div>
+<div id="notVisible" style="visibility: hidden"></div>
+<div id="notInViewport" style="position:absolute; left: 9999999"></div>
+<div id="zeroOpacity" style="opacity: 0"></div>
+```
+
+**isDisplayed.js**
+
+```javascript
+it("should detect if an element is displayed", async ({ browser }) => {
+    let elem = await browser.$("#notDisplayed");
+    let isDisplayed = await elem.isDisplayed();
+    console.log(isDisplayed); // выведет: false
+
+    elem = await browser.$("#notVisible");
+    isDisplayed = await elem.isDisplayed();
+    console.log(isDisplayed); // выведет: false
+
+    elem = await browser.$("#notExisting");
+    isDisplayed = await elem.isDisplayed();
+    console.log(isDisplayed); // выведет: false
+
+    elem = await browser.$("#notInViewport");
+    isDisplayed = await elem.isDisplayed();
+    console.log(isDisplayed); // выведет: true
+
+    elem = await browser.$("#zeroOpacity");
+    isDisplayed = await elem.isDisplayed();
+    console.log(isDisplayed); // выведет: true
+});
+```
diff --git a/docs/commands/element/isDisplayedInViewport.mdx b/docs/commands/element/isDisplayedInViewport.mdx
new file mode 100644
index 0000000..8b00060
--- /dev/null
+++ b/docs/commands/element/isDisplayedInViewport.mdx
@@ -0,0 +1,45 @@
+# isDisplayedInViewport
+
+## Обзор {#overview}
+
+Используйте команду `isDisplayedInViewport`, чтобы определить, отображается ли заданный DOM-элемент во вьюпорте.
+
+Команда возвращает `true`, если выбранный DOM-элемент частично виден и находится во вьюпорте, иначе возвращает `false`.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).isDisplayedInViewport();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div id="notDisplayed" style="display: none"></div>
+<div id="notVisible" style="visibility: hidden"></div>
+<div id="notInViewport" style="position:absolute; left: 9999999"></div>
+<div id="zeroOpacity" style="opacity: 0"></div>
+```
+
+**isDisplayed.js**
+
+```javascript
+it("should detect if an element is visible", async ({ browser }) => {
+    let isDisplayedInViewport = await browser.$("#notDisplayed").isDisplayedInViewport();
+    console.log(isDisplayedInViewport); // выведет: false
+
+    isDisplayedInViewport = await browser.$("#notVisible").isDisplayedInViewport();
+    console.log(isDisplayedInViewport); // выведет: false
+
+    isDisplayedInViewport = await browser.$("#notExisting").isDisplayedInViewport();
+    console.log(isDisplayedInViewport); // выведет: false
+
+    isDisplayedInViewport = await browser.$("#notInViewport").isDisplayedInViewport();
+    console.log(isDisplayedInViewport); // выведет: false
+
+    isDisplayedInViewport = await browser.$("#zeroOpacity").isDisplayedInViewport();
+    console.log(isDisplayedInViewport); // выведет: false
+});
+```
diff --git a/docs/commands/element/isEnabled.mdx b/docs/commands/element/isEnabled.mdx
new file mode 100644
index 0000000..dce02d3
--- /dev/null
+++ b/docs/commands/element/isEnabled.mdx
@@ -0,0 +1,41 @@
+# isEnabled
+
+## Обзор {#overview}
+
+Используйте команду `isEnabled`, чтобы определить включен ли заданный DOM-элемент.
+
+Команда возвращает `true`, если DOM-элемент включен _(enabled)_, иначе возвращает `false`.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).isEnabled();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<input type="text" name="inputField" class="input1">
+<input type="text" name="inputField" class="input2" disabled>
+<input type="text" name="inputField" class="input3" disabled="disabled">
+```
+
+**isEnabled.js**
+
+```javascript
+it("should detect if an element is enabled", async ({ browser }) => {
+    let elem = await browser.$(".input1");
+    let isEnabled = await elem.isEnabled();
+    console.log(isEnabled); // выведет: true
+
+    elem = await browser.$(".input2");
+    isEnabled = await elem.isEnabled();
+    console.log(isEnabled2); // выведет: false
+
+    elem = await browser.$(".input3");
+    isEnabled = await elem.isEnabled();
+    console.log(isEnabled3); // выведет: false
+});
+```
diff --git a/docs/commands/element/isEqual.mdx b/docs/commands/element/isEqual.mdx
new file mode 100644
index 0000000..d5ed079
--- /dev/null
+++ b/docs/commands/element/isEqual.mdx
@@ -0,0 +1,39 @@
+# isEqual
+
+## Обзор {#overview}
+
+Используйте команду `isEqual`, чтобы сравнить заданный DOM-элемент с другим элементом.
+
+Команда возвращает `true`, если выбранный элемент совпадает с предоставленным, иначе возвращает `false`.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).isEqual(el);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>el</td><td>Element</td><td>Элемент, с которым нужно выполнить сравнение.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should detect if an element is clickable", async ({ browser }) => {
+    const el = await browser.$("#el");
+
+    const sameEl = await browser.$("#el");
+    const anotherEl = await browser.$("#anotherEl");
+
+    el.isEqual(sameEl); // выведет: true
+    el.isEqual(anotherEl); // выведет: false
+});
+```
diff --git a/docs/commands/element/isExisting.mdx b/docs/commands/element/isExisting.mdx
new file mode 100644
index 0000000..b634051
--- /dev/null
+++ b/docs/commands/element/isExisting.mdx
@@ -0,0 +1,57 @@
+import Admonition from "@theme/Admonition";
+
+# isExisting
+
+## Обзор {#overview}
+
+Используйте команду `isExisting`, чтобы определить, существует ли заданный DOM-элемент.
+
+Команда возвращает `true`, если выбранный элемент существует, иначе возвращает `false`.
+
+<Admonition type="warning">
+    В отличие от других команд элемента, testplane не будет дожидаться существования элемента, чтобы
+    выполнить эту команду.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).isExisting();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div id="notDisplayed" style="display: none"></div>
+<div id="notVisible" style="visibility: hidden"></div>
+<div id="notInViewport" style="position:absolute; left: 9999999"></div>
+<div id="zeroOpacity" style="opacity: 0"></div>
+```
+
+**isExisting.js**
+
+```javascript
+it("should detect if elements are existing", async ({ browser }) => {
+    let elem = await browser.$("#someRandomNonExistingElement");
+    let isExisting = await elem.isExisting();
+    console.log(isExisting); // выведет: false
+
+    elem = await browser.$("#notDisplayed");
+    isExisting = await elem.isExisting();
+    console.log(isExisting); // выведет: true
+
+    elem = await browser.$("#notVisible");
+    isExisting = await elem.isExisting();
+    console.log(isExisting); // выведет: true
+
+    elem = await browser.$("#notInViewport");
+    isExisting = await elem.isExisting();
+    console.log(isExisting); // выведет: true
+
+    elem = await browser.$("#zeroOpacity");
+    isExisting = await elem.isExisting();
+    console.log(isExisting); // выведет: true
+});
+```
diff --git a/docs/commands/element/isFocused.mdx b/docs/commands/element/isFocused.mdx
new file mode 100644
index 0000000..770e13b
--- /dev/null
+++ b/docs/commands/element/isFocused.mdx
@@ -0,0 +1,36 @@
+# isFocused
+
+## Обзор {#overview}
+
+Используйте команду `isFocused`, чтобы определить, есть ли фокус на заданном DOM-элементе.
+
+Команда возвращает `true`, если выбранный элемент находится в фокусе, иначе возвращает `false`.
+
+Если под селектор попадает множество элементов, то команда возвращает `true`, если хотя бы один из элементов находится в фокусе.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).isFocused();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<input name="login" autofocus="" />
+```
+
+**isFocused.js**
+
+```javascript
+it("should detect the focus of an element", async ({ browser }) => {
+    await browser.url("/");
+    const loginInput = await browser.$('[name="login"]');
+    console.log(await loginInput.isFocused()); // выведет: false
+
+    await loginInput.click();
+    console.log(await loginInput.isFocused()); // выведет: true
+});
+```
diff --git a/docs/commands/element/isSelected.mdx b/docs/commands/element/isSelected.mdx
new file mode 100644
index 0000000..1b9347a
--- /dev/null
+++ b/docs/commands/element/isSelected.mdx
@@ -0,0 +1,39 @@
+# isSelected
+
+## Обзор {#overview}
+
+Используйте команду `isSelected`, чтобы определить, выбрана ли заданная опция `<option>` или `<input>` типа `checkbox` или `radio`.
+
+Команда возвращает `true`, если элемент выбран, иначе возвращает `false`.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).isSelected();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<select name="selectbox" id="selectbox">
+    <option value="John Doe">John Doe</option>
+    <option value="Layla Terry" selected="selected">
+        Layla Terry
+    </option>
+    <option value="Bill Gilbert">Bill Gilbert"</option>
+</select>
+```
+
+**isSelected.js**
+
+```javascript
+it("should detect if an element is selected", async ({ browser }) => {
+    let element = await browser.$('[value="Layla Terry"]');
+    console.log(await element.isSelected()); // выведет: true
+
+    element = await browser.$('[value="Bill Gilbert"]');
+    console.log(await element.isSelected()); // выведет: false
+});
+```
diff --git a/docs/commands/element/moveTo.mdx b/docs/commands/element/moveTo.mdx
new file mode 100644
index 0000000..c5aaec2
--- /dev/null
+++ b/docs/commands/element/moveTo.mdx
@@ -0,0 +1,28 @@
+# moveTo
+
+## Обзор {#overview}
+
+Используйте команду `moveTo`, чтобы сместить мышь на заданные расстояния по осям X и Y относительно указанного элемента.
+
+Если элемент не указан, то перемещение будет выполнено относительно текущего курсора мыши.
+Если элемент указан, а смещения по осям не указаны, то мышь будет перемещена в центр элемента.
+Если элемент не виден, то будет выполнен подскролл так, чтобы элемент стал виден.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).moveTo({ xOffset, yOffset });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>xOffset</td><td>Number</td><td>Смещение по оси X. Задается относительно верхнего левого угла элемента. Если не указано, мышь переместится в середину элемента.</td></tr>
+<tr><td>yOffset</td><td>Number</td><td>Смещение по оси Y. Задается относительно верхнего левого угла элемента. Если не указано, мышь переместится в середину элемента.</td></tr>
+
+</tbody>
+</table>
diff --git a/docs/commands/element/nextElement.mdx b/docs/commands/element/nextElement.mdx
new file mode 100644
index 0000000..e04dc18
--- /dev/null
+++ b/docs/commands/element/nextElement.mdx
@@ -0,0 +1,39 @@
+# nextElement
+
+## Обзор {#overview}
+
+Используйте команду `nextElement`, чтобы получить следующий дочерний элемент выбранного DOM-элемента.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).nextElement();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div class="parent">
+    <p>Sibling One</p>
+    <p>Sibling Two</p>
+    <p>Sibling Three</p>
+</div>
+```
+
+**nextElement.js**
+
+```javascript
+it("should get text from next sibling element", async ({ browser }) => {
+    const elem = await browser.$$("p");
+    const nextElement = await elem[1].nextElement();
+
+    console.log(await nextElement.getText()); // выведет: "Sibling Three"
+});
+```
+
+## Связанные команды {#related}
+
+-   [parentElement](./parentElement)
+-   [previousElement](./previousElement)
diff --git a/docs/commands/element/parentElement.mdx b/docs/commands/element/parentElement.mdx
new file mode 100644
index 0000000..32c0fd6
--- /dev/null
+++ b/docs/commands/element/parentElement.mdx
@@ -0,0 +1,39 @@
+# parentElement
+
+## Обзор {#overview}
+
+Используйте команду `parentElement`, чтобы получить родительский элемент выбранного DOM-элемента.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).parentElement();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div class="parent">
+    <p>Sibling One</p>
+    <p>Sibling Two</p>
+    <p>Sibling Three</p>
+</div>
+```
+
+**parentElement.js**
+
+```javascript
+it("should get class from parent element", async ({ browser }) => {
+    const elem = await browser.$$("p");
+    const parent = await elem[2].parentElement();
+
+    console.log(await parent.getAttribute("class")); // выведет: "parent"
+});
+```
+
+## Связанные команды {#related}
+
+-   [previousElement](./previousElement)
+-   [nextElement](./nextElement)
diff --git a/docs/commands/element/previousElement.mdx b/docs/commands/element/previousElement.mdx
new file mode 100644
index 0000000..b4cf9aa
--- /dev/null
+++ b/docs/commands/element/previousElement.mdx
@@ -0,0 +1,39 @@
+# previousElement
+
+## Обзор {#overview}
+
+Используйте команду `previousElement`, чтобы получить предыдущий дочерний элемент выбранного DOM-элемента.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).previousElement();
+```
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div class="parent">
+    <p>Sibling One</p>
+    <p>Sibling Two</p>
+    <p>Sibling Three</p>
+</div>
+```
+
+**previousElement.js**
+
+```javascript
+it("should get text from previous sibling element", async ({ browser }) => {
+    const elem = await browser.$$("p");
+    const previousElement = await elem[1].previousElement();
+
+    console.log(await previousElement.getText()); // выведет: "Sibling One"
+});
+```
+
+## Связанные команды {#related}
+
+-   [parentElement](./parentElement)
+-   [nextElement](./nextElement)
diff --git a/docs/commands/element/reactDollar.mdx b/docs/commands/element/reactDollar.mdx
new file mode 100644
index 0000000..e90eb68
--- /dev/null
+++ b/docs/commands/element/reactDollar.mdx
@@ -0,0 +1,77 @@
+import Admonition from "@theme/Admonition";
+
+# react$
+
+## Обзор {#overview}
+
+Используйте команду `react$`, чтобы найти на странице React-компоненты по их настоящему имени, одновременно фильтруя их по props'ам и состоянию.
+
+<Admonition type="warning">
+Команда _react$_ работает только в приложениях, которые используют _React v16.x._
+
+Читайте больше о React-селекторах в рецепте «[Как использовать селекторы][how-to-use-selectors]».
+
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).react$(reactComponentSelector, { props, state });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>reactComponentSelector</td><td>String</td><td>Селектор React-компонента.</td></tr>
+<tr><td>props</td><td>Object</td><td>React-свойства, которые должен иметь компонент.</td></tr>
+<tr><td>state</td><td>Any или Any[]</td><td>React-состояние, в котором должен находиться компонент.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should calculate 7 * 6", async ({ browser }) => {
+    await browser.url("https://ahfarmer.github.io/calculator/");
+    const appWrapper = await browser.$("div#root");
+
+    await appWrapper
+        .react$("t", {
+            props: { name: "7" },
+        })
+        .click();
+
+    await appWrapper
+        .react$("t", {
+            props: { name: "x" },
+        })
+        .click();
+
+    await appWrapper
+        .react$("t", {
+            props: { name: "6" },
+        })
+        .click();
+
+    await appWrapper
+        .react$("t", {
+            props: { name: "=" },
+        })
+        .click();
+
+    console.log(await browser.$(".component-display").getText()); // выведет: "42"
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.react$](../browser/reactDollar)
+-   [browser.react$$](../browser/reactDollarDollar)
+-   [element.react$$](./reactDollarDollar)
+
+[how-to-use-selectors]: https://webdriver.io/docs/selectors
diff --git a/docs/commands/element/reactDollarDollar.mdx b/docs/commands/element/reactDollarDollar.mdx
new file mode 100644
index 0000000..682f478
--- /dev/null
+++ b/docs/commands/element/reactDollarDollar.mdx
@@ -0,0 +1,58 @@
+import Admonition from "@theme/Admonition";
+
+# react$$
+
+## Обзор {#overview}
+
+Используйте команду `react$$`, чтобы найти на странице множество React-компонентов по их настоящему имени, одновременно фильтруя их по props'ам и состоянию.
+
+<Admonition type="warning">
+Команда _react$_ работает только в приложениях, которые используют _React v16.x._
+
+Читайте больше о React-селекторах в рецепте «[Как использовать селекторы][how-to-use-selectors]».
+
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.react$$(reactComponentSelector, { props, state });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>reactComponentSelector</td><td>String</td><td>Селектор React-компонента.</td></tr>
+<tr><td>props</td><td>Object</td><td>React-свойства, которые должен иметь компонент.</td></tr>
+<tr><td>state</td><td>Any или Any[]</td><td>React-состояние, в котором должен находиться компонент.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should calculate 7 * 6", async ({ browser }) => {
+    await browser.url("https://ahfarmer.github.io/calculator/");
+    const appWrapper = await browser.$("div#root");
+
+    const orangeButtons = await appWrapper.react$$("t", {
+        props: { orange: true },
+    });
+
+    console.log(await Promise.all(orangeButtons.map(btn => btn.getText())));
+    // выведет: "[ '÷', 'x', '-', '+', '=' ]"
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.react$](../browser/reactDollar)
+-   [browser.react$$](../browser/reactDollarDollar)
+-   [element.react$](./reactDollar)
+
+[how-to-use-selectors]: https://webdriver.io/docs/selectors
diff --git a/docs/commands/element/saveScreenshot.mdx b/docs/commands/element/saveScreenshot.mdx
new file mode 100644
index 0000000..5abeb1e
--- /dev/null
+++ b/docs/commands/element/saveScreenshot.mdx
@@ -0,0 +1,32 @@
+# saveScreenshot
+
+## Обзор {#overview}
+
+Используйте команду `saveScreenshot`, чтобы сохранить скриншот элемента в png-файл.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).saveScreenshot(filepath);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>filepath</td><td>String</td><td>Путь к скриншоту относительно каталога выполнения (расширение .png — обязательно).</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should save a screenshot of the browser view", async ({ browser }) => {
+    const elem = await browser.$("#someElem");
+    await elem.saveScreenshot("./some/path/elemScreenshot.png");
+});
+```
diff --git a/docs/commands/element/scrollIntoView.mdx b/docs/commands/element/scrollIntoView.mdx
new file mode 100644
index 0000000..4714225
--- /dev/null
+++ b/docs/commands/element/scrollIntoView.mdx
@@ -0,0 +1,64 @@
+import Admonition from "@theme/Admonition";
+
+# scrollIntoView
+
+## Обзор {#overview}
+
+Используйте команду `scrollIntoView`, чтобы выполнить подскролл к заданному элементу.
+
+<Admonition type="info">
+    Читайте также [Element.scrollIntoView()][scroll-into-view] на MDN.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).scrollIntoView();
+```
+
+или
+
+```javascript
+await browser.$(selector).scrollIntoView(alignToTop);
+```
+
+или
+
+```javascript
+await browser.$(selector).scrollIntoView({ behavior, block, inline });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>alignToTop</td><td>Boolean</td><td>true</td><td>Если значение _true_, то верхняя граница элемента будет выровнена по верху видимой области скроллируемого предка. Соответствует _\{block: 'start', inline: 'nearest'}_. Если значение _false_, нижняя граница элемента будет выровнена по низу видимой области скроллируемого предка. Соответствует _\{block: 'end', inline: 'nearest'}_.</td></tr>
+<tr><td>behavior</td><td>String</td><td>"auto"</td><td>Задает анимацию прокрутки: "auto" или "smooth".</td></tr>
+<tr><td>block</td><td>String</td><td>"start"</td><td>Задает вертикальное выравнивание: "start", "center", "end" или "nearest".</td></tr>
+<tr><td>inline</td><td>String</td><td>"nearest"</td><td>Задает горизонтальное выравнивание: "start", "center", "end" или "nearest".</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should demonstrate the scrollIntoView command", async ({ browser }) => {
+    const elem = await browser.$("#myElement");
+
+    // выполнить подскролл к элементу
+    await elem.scrollIntoView();
+
+    // подскроллировать так, чтобы элемент был по центру вьюпорта
+    await elem.scrollIntoView({ block: "center", inline: "center" });
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.scroll](../browser/scroll)
+
+[scroll-into-view]: https://developer.mozilla.org/ru/docs/Web/API/Element/scrollIntoView
diff --git a/docs/commands/element/selectByAttribute.mdx b/docs/commands/element/selectByAttribute.mdx
new file mode 100644
index 0000000..ef8925b
--- /dev/null
+++ b/docs/commands/element/selectByAttribute.mdx
@@ -0,0 +1,62 @@
+# selectByAttribute
+
+## Обзор {#overview}
+
+Используйте команду `selectByAttribute`, чтобы выбрать опцию с определенным значением.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).selectByAttribute(attribute, value);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>attribute</td><td>String</td><td>Атрибут (опции), по которому нужно выбрать опцию.</td></tr>
+<tr><td>value</td><td>String или Number</td><td>Значение (опции), по которому нужно выбрать опцию.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**example.html**
+
+```javascript
+<select id="selectbox">
+    <option value="someValue0">uno</option>
+    <option value="someValue1">dos</option>
+    <option value="someValue2">tres</option>
+    <option value="someValue3">cuatro</option>
+    <option value="someValue4">cinco</option>
+    <option name="someName5" value="someValue5">
+        seis
+    </option>
+</select>
+```
+
+**selectByAttribute.js**
+
+```javascript
+it("should demonstrate the selectByAttribute command", async ({ browser }) => {
+    const selectBox = await browser.$("#selectbox");
+    const value = await selectBox.getValue();
+    console.log(value); // выведет: "someValue0"
+
+    await selectBox.selectByAttribute("value", "someValue3");
+    console.log(await selectBox.getValue()); // выведет: "someValue3"
+
+    await selectBox.selectByAttribute("name", "someName5");
+    console.log(await selectBox.getValue()); // выведет: "someValue5"
+});
+```
+
+## Связанные команды {#related}
+
+-   [selectByIndex](./selectByIndex)
+-   [selectByVisibleText](./selectByVisibleText)
diff --git a/docs/commands/element/selectByIndex.mdx b/docs/commands/element/selectByIndex.mdx
new file mode 100644
index 0000000..2de6457
--- /dev/null
+++ b/docs/commands/element/selectByIndex.mdx
@@ -0,0 +1,55 @@
+# selectByIndex
+
+## Обзор {#overview}
+
+Используйте команду `selectByIndex`, чтобы выбрать опцию с определенным значением.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).selectByIndex(index);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>index</td><td>Number</td><td>Индекс (опции), по которому нужно выбрать опцию.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**example.html**
+
+```javascript
+<select id="selectbox">
+    <option value="someValue0">uno</option>
+    <option value="someValue1">dos</option>
+    <option value="someValue2">tres</option>
+    <option value="someValue3">cuatro</option>
+    <option value="someValue4">cinco</option>
+    <option value="someValue5">seis</option>
+</select>
+```
+
+**selectByIndex.js**
+
+```javascript
+it("should demonstrate the selectByIndex command", async ({ browser }) => {
+    const selectBox = await browser.$("#selectbox");
+    console.log(await selectBox.getValue()); // выведет: "someValue0"
+
+    await selectBox.selectByIndex(4);
+    console.log(await selectBox.getValue()); // выведет: "someValue4"
+});
+```
+
+## Связанные команды {#related}
+
+-   [selectByAttribute](./selectByAttribute)
+-   [selectByVisibleText](./selectByVisibleText)
diff --git a/docs/commands/element/selectByVisibleText.mdx b/docs/commands/element/selectByVisibleText.mdx
new file mode 100644
index 0000000..10a19e9
--- /dev/null
+++ b/docs/commands/element/selectByVisibleText.mdx
@@ -0,0 +1,55 @@
+# selectByVisibleText
+
+## Обзор {#overview}
+
+Используйте команду `selectByVisibleText`, чтобы выбрать опцию с заданным отображаемым текстом.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).selectByVisibleText(text);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>text</td><td>String или Number</td><td>Текст (опции), по которому нужно выбрать опцию.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**example.html**
+
+```javascript
+<select id="selectbox">
+    <option value="someValue0">uno</option>
+    <option value="someValue1">dos</option>
+    <option value="someValue2">tres</option>
+    <option value="someValue3">cuatro</option>
+    <option value="someValue4">cinco</option>
+    <option value="someValue5">seis</option>
+</select>
+```
+
+**selectByVisibleText.js**
+
+```javascript
+it("demonstrate the selectByVisibleText command", async ({ browser }) => {
+    const selectBox = await browser.$("#selectbox");
+    console.log(await selectBox.getText("option:checked")); // выведет: "uno"
+
+    await selectBox.selectByVisibleText("cuatro");
+    console.log(await selectBox.getText("option:checked")); // выведет: "cuatro"
+});
+```
+
+## Связанные команды {#related}
+
+-   [selectByAttribute](./selectByAttribute)
+-   [selectByIndex](./selectByIndex)
diff --git a/docs/commands/element/setValue.mdx b/docs/commands/element/setValue.mdx
new file mode 100644
index 0000000..61de813
--- /dev/null
+++ b/docs/commands/element/setValue.mdx
@@ -0,0 +1,53 @@
+import Admonition from "@theme/Admonition";
+
+# setValue
+
+## Обзор {#overview}
+
+Используйте команду `setValue`, чтобы отправить последовательность нажатий клавиш элементу после того, как поле ввода было предварительно очищено.
+
+Если элемент не нужно сначала очищать, используйте команду [addValue][add-value].
+
+<Admonition type="info">
+    Если вы хотите использовать специальные символы, например, для копирования и вставки значения из
+    одного ввода в другой, используйте команду [keys][keys].
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).setValue(value);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>value</td><td>String или Number</td><td>Значение, которое нужно установить.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should set value for a certain element", async ({ browser }) => {
+    const input = await browser.$(".input");
+    await input.setValue("test");
+    await input.setValue(123);
+
+    console.log(await input.getValue()); // выведет: '123'
+});
+```
+
+## Связанные команды {#related}
+
+-   [element.addValue][add-value]
+-   [element.clearValue](./clearValue)
+-   [browser.keys][keys]
+
+[add-value]: ./addValue
+[keys]: ../browser/keys
diff --git a/docs/commands/element/shadowDollar.mdx b/docs/commands/element/shadowDollar.mdx
new file mode 100644
index 0000000..45ff073
--- /dev/null
+++ b/docs/commands/element/shadowDollar.mdx
@@ -0,0 +1,38 @@
+# shadow$
+
+## Обзор {#overview}
+
+Используйте команду `shadow$`, чтобы получить доступ к элементу внутри [ShadowRoot][shadow-root] данного элемента.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).shadow$$(shadowSelector);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>shadowSelector</td><td>String или Function</td><td>Селектор или JS-функция для получения определенного элемента.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should return an element inside a ShadowRoot", async ({ browser }) => {
+    const innerEl = await browser.$(".input").shadow$("#innerEl");
+    console.log(await innerEl.getValue()); // выведет: 'test123'
+});
+```
+
+## Связанные команды {#related}
+
+-   [shadow$$](./shadowDollarDollar)
+
+[shadow-root]: https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot
diff --git a/docs/commands/element/shadowDollarDollar.mdx b/docs/commands/element/shadowDollarDollar.mdx
new file mode 100644
index 0000000..a4966f3
--- /dev/null
+++ b/docs/commands/element/shadowDollarDollar.mdx
@@ -0,0 +1,38 @@
+# shadow$$
+
+## Обзор {#overview}
+
+Используйте команду `shadow$$`, чтобы получить доступ к элементам внутри [ShadowRoot][shadow-root] данного элемента.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).shadow$$(shadowSelector);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>shadowSelector</td><td>String или Function</td><td>Селектор или JS-функция для получения определенного элемента (или элементов).</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should return elements inside a ShadowRoot", async ({ browser }) => {
+    const innerEl = await browser.$(".input").shadow$$("#innerEl");
+    console.log(await innerEl.getValue()); // выведет: 'test123'
+});
+```
+
+## Связанные команды {#related}
+
+-   [shadow$](./shadowDollar)
+
+[shadow-root]: https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot
diff --git a/docs/commands/element/touchAction.mdx b/docs/commands/element/touchAction.mdx
new file mode 100644
index 0000000..fc17352
--- /dev/null
+++ b/docs/commands/element/touchAction.mdx
@@ -0,0 +1,73 @@
+import Admonition from "@theme/Admonition";
+
+# touchAction
+
+## Обзор {#overview}
+
+Используйте команду `touchAction`, чтобы выполнить жесты в тестах на мобильной платформе.
+
+Команда позволяет связывать воедино отдельные действия _[ad hoc][ad-hoc]_, которые затем будут применены к элементу приложения на устройстве.
+
+Основные действия, которые можно использовать:
+
+-   **press** — нужно указать element или координаты (x, y), или и то, и другое
+-   **longPress** — нужно указать element или координаты (x, y), или и то, и другое
+-   **tap** — нужно указать element или координаты (x, y), или и то, и другое
+-   **moveTo** — нужно указать абсолютные координаты (x, y)
+-   **wait** — нужно указать время в миллисекундах
+-   **release** — ничего указывать не нужно
+
+<Admonition type="warning">
+    В настоящее время команда _touchAction_ доступна только для нативных приложений и не может
+    использоваться для взаимодействия с веб-приложениями.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).touchAction(action);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>action</td><td>Object</td><td>Действие, которое надо выполнить.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should do a touch gesture", async ({ browser }) => {
+    const screen = await browser.$("//UITextbox");
+
+    // простой touch action на элементе
+    await screen.touchAction("tap");
+
+    // простой touch action с координатами x и y
+    // координаты касания – 30px направо и 20px вниз относительно центра элемента
+    await screen.touchAction({
+        action: "tap",
+        x: 30,
+        y: 20,
+    });
+
+    // multi action на элементе (drag&drop)
+    await screen.touchAction(["press", { action: "moveTo", x: 200, y: 300 }, "release"]);
+
+    // drag&drop на элемент
+    const otherElement = await browser.$("//UIAApplication[1]/UIAElement[2]");
+    await screen.touchAction(["press", { action: "moveTo", element: otherElement }, "release"]);
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.touchAction](../browser/touchAction)
+
+[ad-hoc]: https://ru.wikipedia.org/wiki/Ad_hoc
diff --git a/docs/commands/element/waitForClickable.mdx b/docs/commands/element/waitForClickable.mdx
new file mode 100644
index 0000000..d6a5910
--- /dev/null
+++ b/docs/commands/element/waitForClickable.mdx
@@ -0,0 +1,49 @@
+import Admonition from "@theme/Admonition";
+
+# waitForClickable
+
+## Обзор {#overview}
+
+Используйте команду `waitForClickable`, чтобы подождать, пока элемент в течение указанного количества миллисекунд не станет кликабельным или не кликабельным.
+
+<Admonition type="warning">
+    В отличие от других команд элемента, testplane не будет дожидаться существования элемента, чтобы
+    выполнить эту команду.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).waitForClickable({ timeout, reverse, timeoutMsg, interval });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>timeout</td><td>Number</td><td>500</td><td>Таймаут в миллисекундах.</td></tr>
+<tr><td>reverse</td><td>Boolean</td><td>false</td><td>Если значение _true_, то команда будет ждать противоположного условия: что элемент не кликабельный.</td></tr>
+<tr><td>timeoutMsg</td><td>String</td><td>_N/A_</td><td>Сообщение об ошибке, которое нужно бросить при таймауте.</td></tr>
+<tr><td>interval</td><td>Number</td><td>[waitforInterval][wait-for-interval]</td><td>Интервал в миллисекундах между проверками условия.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should detect when element is clickable", async ({ browser }) => {
+    const elem = await browser.$("#elem");
+    await elem.waitForClickable({ timeout: 3000 });
+});
+
+it("should detect when element is no longer clickable", async ({ browser }) => {
+    const elem = await browser.$("#elem");
+    await elem.waitForClickable({ reverse: true });
+});
+```
+
+[wait-for-interval]: ../../config/browsers#wait_interval
diff --git a/docs/commands/element/waitForDisplayed.mdx b/docs/commands/element/waitForDisplayed.mdx
new file mode 100644
index 0000000..8b43cbc
--- /dev/null
+++ b/docs/commands/element/waitForDisplayed.mdx
@@ -0,0 +1,62 @@
+import Admonition from "@theme/Admonition";
+
+# waitForDisplayed
+
+## Обзор {#overview}
+
+Используйте команду `waitForDisplayed`, чтобы подождать, пока элемент в течение указанного количества миллисекунд не станет отображаемым или не отображаемым.
+
+<Admonition type="warning">
+    В отличие от других команд элемента, testplane не будет дожидаться существования элемента, чтобы
+    выполнить эту команду.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).waitForDisplayed({ timeout, reverse, timeoutMsg, interval });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>timeout</td><td>Number</td><td>500</td><td>Таймаут в миллисекундах.</td></tr>
+<tr><td>reverse</td><td>Boolean</td><td>false</td><td>Если значение _true_, то команда будет ждать противоположного условия: что элемент не отображается.</td></tr>
+<tr><td>timeoutMsg</td><td>String</td><td>_N/A_</td><td>Сообщение об ошибке, которое нужно бросить при таймауте.</td></tr>
+<tr><td>interval</td><td>Number</td><td>[waitforInterval][wait-for-interval]</td><td>Интервал в миллисекундах между проверками условия.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div id="elem" style="visibility: hidden;">Hello World!</div>
+<script type="text/javascript">
+    setTimeout(() => {
+        document.getElementById('elem').style.visibility = 'visible';
+    }, 2000);
+</script>
+```
+
+**waitForDisplayed.js**
+
+```javascript
+it("should detect when element is visible", async ({ browser }) => {
+    const elem = await browser.$("#elem");
+    await elem.waitForDisplayed({ timeout: 3000 });
+});
+
+it("should detect when element is no longer visible", async ({ browser }) => {
+    const elem = await browser.$("#elem");
+    await elem.waitForDisplayed({ reverse: true });
+});
+```
+
+[wait-for-interval]: ../../config/browsers#wait_interval
diff --git a/docs/commands/element/waitForEnabled.mdx b/docs/commands/element/waitForEnabled.mdx
new file mode 100644
index 0000000..109fcbb
--- /dev/null
+++ b/docs/commands/element/waitForEnabled.mdx
@@ -0,0 +1,62 @@
+import Admonition from "@theme/Admonition";
+
+# waitForEnabled
+
+## Обзор {#overview}
+
+Используйте команду `waitForEnabled`, чтобы подождать, пока элемент в течение указанного количества миллисекунд не станет включенным _(enabled)_ или отключенным _(disabled)_.
+
+<Admonition type="warning">
+    В отличие от других команд элемента, testplane не будет дожидаться существования элемента, чтобы
+    выполнить эту команду.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).waitForEnabled({ timeout, reverse, timeoutMsg, interval });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>timeout</td><td>Number</td><td>500</td><td>Таймаут в миллисекундах.</td></tr>
+<tr><td>reverse</td><td>Boolean</td><td>false</td><td>Если значение _true_, то команда будет ждать противоположного условия: что элемент отключен _(disabled)_.</td></tr>
+<tr><td>timeoutMsg</td><td>String</td><td>_N/A_</td><td>Сообщение об ошибке, которое нужно бросить при таймауте.</td></tr>
+<tr><td>interval</td><td>Number</td><td>[waitforInterval][wait-for-interval]</td><td>Интервал в миллисекундах между проверками условия.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**index.html**
+
+```javascript
+<div id="elem" style="visibility: hidden;">Hello World!</div>
+<script type="text/javascript">
+    setTimeout(() => {
+        document.getElementById('elem').style.visibility = 'visible';
+    }, 2000);
+</script>
+```
+
+**waitForEnabled.js**
+
+```javascript
+it("should detect when element is visible", async ({ browser }) => {
+    const elem = await browser.$("#elem");
+    await elem.waitForDisplayed({ timeout: 3000 });
+});
+
+it("should detect when element is no longer visible", async ({ browser }) => {
+    const elem = await browser.$("#elem");
+    await elem.waitForDisplayed({ reverse: true });
+});
+```
+
+[wait-for-interval]: ../../config/browsers#wait_interval
diff --git a/docs/commands/element/waitForExist.mdx b/docs/commands/element/waitForExist.mdx
new file mode 100644
index 0000000..6b84410
--- /dev/null
+++ b/docs/commands/element/waitForExist.mdx
@@ -0,0 +1,59 @@
+import Admonition from "@theme/Admonition";
+
+# waitForExist
+
+## Обзор {#overview}
+
+Используйте команду `waitForExist`, чтобы подождать, пока элемент в течение указанного количества миллисекунд не появится в DOM.
+
+Команда возвращает значение `true`, если селектор соответствует хотя бы одному элементу, существующему в DOM, в противном случае выдает ошибку. Если параметр `reverse` имеет значение `true`, то команда поменяет логику и вернет значение `true`, если селектор не соответствует ни одному элементу.
+
+<Admonition type="warning">
+    В отличие от других команд элемента, testplane не будет дожидаться существования элемента, чтобы
+    выполнить эту команду.
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).waitForExist({ timeout, reverse, timeoutMsg, interval });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>timeout</td><td>Number</td><td>500</td><td>Таймаут в миллисекундах.</td></tr>
+<tr><td>reverse</td><td>Boolean</td><td>false</td><td>Если значение _true_, то команда будет ждать противоположного условия: что элемент не отображается.</td></tr>
+<tr><td>timeoutMsg</td><td>String</td><td>_N/A_</td><td>Сообщение об ошибке, которое нужно бросить при таймауте.</td></tr>
+<tr><td>interval</td><td>Number</td><td>[waitforInterval][wait-for-interval]</td><td>Интервал в миллисекундах между проверками условия.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should display a notification message after successful form submit", async ({ browser }) => {
+    const form = await browser.$("form");
+    const notification = await browser.$(".notification");
+
+    await form.$(".send").click();
+    await notification.waitForExist({ timeout: 5000 });
+
+    assert.equal(await notification.getText(), "Data transmitted successfully!");
+});
+
+it("should remove a message after successful form submit", async ({ browser }) => {
+    const form = await browser.$("form");
+    const message = await browser.$(".message");
+
+    await form.$(".send").click();
+    await message.waitForExist({ reverse: true });
+});
+```
+
+[wait-for-interval]: ../../config/browsers#wait_interval
diff --git a/docs/commands/element/waitUntil.mdx b/docs/commands/element/waitUntil.mdx
new file mode 100644
index 0000000..4518b18
--- /dev/null
+++ b/docs/commands/element/waitUntil.mdx
@@ -0,0 +1,61 @@
+# waitUntil
+
+## Обзор {#overview}
+
+Используйте команду `waitUntil`, чтобы дождаться соблюдения определенного условия на странице в браузере.
+
+## Использование {#usage}
+
+```javascript
+await browser.$(selector).waitUntil(condition, { timeout, timeoutMsg, interval });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>condition</td><td>Function</td><td>_N/A_</td><td>Условие, которое нужно ждать.</td></tr>
+<tr><td>timeout</td><td>Number</td><td>5000</td><td>Таймаут в миллисекундах.</td></tr>
+<tr><td>timeoutMsg</td><td>String</td><td>_N/A_</td><td>Сообщение об ошибке, которое нужно бросить при таймауте.</td></tr>
+<tr><td>interval</td><td>Number</td><td>500</td><td>Интервал в миллисекундах между проверками условия.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+**example.html**
+
+```javascript
+<div id="someText">I am some text</div>
+<script>
+    setTimeout(() => {
+        await $('#someText').html('I am now different');
+    }, 1000);
+</script>
+```
+
+**waitUntil.js**
+
+```javascript
+it("should wait until text has changed", async ({ browser }) => {
+    const elem = await browser.$("#someText");
+
+    await elem.waitUntil(
+        async function () {
+            return (await this.getText()) === "I am now different";
+        },
+        {
+            timeout: 5000,
+            timeoutMsg: "expected text to be different after 5s",
+        },
+    );
+});
+```
+
+## Связанные команды {#related}
+
+-   [browser.waitUntil](../browser/waitUntil)
diff --git a/docs/commands/expect/browser-matchers.mdx b/docs/commands/expect/browser-matchers.mdx
new file mode 100644
index 0000000..d494bf5
--- /dev/null
+++ b/docs/commands/expect/browser-matchers.mdx
@@ -0,0 +1,47 @@
+# expect для браузера
+
+## toHaveUrl
+
+Проверяет, находится ли браузер на заданной странице.
+
+Например:
+
+```javascript
+await browser.url("https://webdriver.io/");
+await expect(browser).toHaveUrl("https://webdriver.io");
+```
+
+## toHaveUrlContaining
+
+Проверяет, есть ли заданная подстрока в URL-адресе страницы, на которой находится браузер.
+
+Например:
+
+```javascript
+await browser.url("https://webdriver.io/");
+await expect(browser).toHaveUrlContaining("webdriver");
+```
+
+## toHaveTitle
+
+Проверяет, есть ли у веб-сайта заданный заголовок.
+
+Например:
+
+```javascript
+await browser.url("https://webdriver.io/");
+await expect(browser).toHaveTitle(
+    "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js",
+);
+```
+
+## toHaveTitleContaining
+
+Проверяет, есть ли заданная подстрока в заголовке веб-сайта.
+
+Например:
+
+```javascript
+await browser.url("https://webdriver.io/");
+await expect(browser).toHaveTitleContaining("WebdriverIO");
+```
diff --git a/docs/commands/expect/element-matchers.mdx b/docs/commands/expect/element-matchers.mdx
new file mode 100644
index 0000000..21f9e13
--- /dev/null
+++ b/docs/commands/expect/element-matchers.mdx
@@ -0,0 +1,353 @@
+# expect для элементов
+
+## toBeDisplayed
+
+Вызывает [isDisplayed](../element/isDisplayed) на заданном элементе.
+
+Например:
+
+```javascript
+const elem = await browser.$("#someElem");
+await expect(elem).toBeDisplayed();
+```
+
+## toExist
+
+Вызывает [isExisting](../element/isExisting) на заданном элементе.
+
+Например:
+
+```javascript
+const elem = await browser.$("#someElem");
+await expect(elem).toExist();
+```
+
+## toBePresent
+
+То же, что и [toExist](#toexist).
+
+Например:
+
+```javascript
+const elem = await browser.$("#someElem");
+await expect(elem).toBePresent();
+```
+
+## toBeExisting
+
+То же, что и [toExist](#toexist).
+
+Например:
+
+```javascript
+const elem = await browser.$("#someElem");
+await expect(elem).toBeExisting();
+```
+
+## toBeFocused
+
+Проверяет, есть ли фокус на элементе. Это утверждение работает только в веб-контексте.
+
+Например:
+
+```javascript
+const elem = await browser.$("#someElem");
+await expect(elem).toBeFocused();
+```
+
+## toHaveAttribute
+
+Проверяет, есть ли у элемента атрибут с заданным значением.
+
+Например:
+
+```javascript
+const myInput = await browser.$("input");
+await expect(myInput).toHaveAttribute("class", "form-control");
+```
+
+## toHaveAttr
+
+То же, что и [toHaveAttribute](#tohaveattribute).
+
+Например:
+
+```javascript
+const myInput = await browser.$("input");
+await expect(myInput).toHaveAttr("class", "form-control");
+```
+
+## toHaveAttributeContaining
+
+Проверяет, есть ли заданная подстрока в значении указанного атрибута элемента.
+
+Например:
+
+```javascript
+const myInput = await browser.$("input");
+await expect(myInput).toHaveAttributeContaining("class", "form");
+```
+
+## toHaveAttrContaining
+
+То же, что и [toHaveAttributeContaining](#tohaveattrcontaining).
+
+Например:
+
+```javascript
+const myInput = await browser.$("input");
+await expect(myInput).toHaveAttrContaining("class", "form");
+```
+
+## toHaveElementClass
+
+Проверяет, есть ли у элемента заданное имя класса.
+
+Например:
+
+```javascript
+const myInput = await browser.$("input");
+await expect(myInput).toHaveElementClass("form-control", { message: "Not a form control!" });
+```
+
+## toHaveElementClassContaining
+
+Проверяет, есть ли у элемент имя класса, которое содержит в качестве подстроки заданное значение.
+
+Например:
+
+```javascript
+const myInput = await browser.$("input");
+await expect(myInput).toHaveElementClassContaining("form");
+```
+
+## toHaveElementProperty
+
+Проверяет, есть ли у элемента указанное свойство с заданным значением.
+
+Например:
+
+```javascript
+const elem = await browser.$("#elem");
+await expect(elem).toHaveElementProperty("height", 23);
+await expect(elem).not.toHaveElementProperty("height", 0);
+```
+
+## toHaveValue
+
+Проверяет, имеет ли input-элемент заданное значение.
+
+Например:
+
+```javascript
+const myInput = await browser.$("input");
+await expect(myInput).toHaveValue("user", { ignoreCase: true });
+```
+
+## toHaveValueContaining
+
+Проверяет, есть ли заданная подстрока в значении указанного input-элемента.
+
+Например:
+
+```javascript
+const myInput = await browser.$("input");
+await expect(myInput).toHaveValueContaining("us");
+```
+
+## toBeClickable
+
+Проверяет, можно ли щелкнуть по элементу с помощью вызова [isClickable](../element/isClickable).
+
+Например:
+
+```javascript
+const elem = await browser.$("#elem");
+await expect(elem).toBeClickable();
+```
+
+## toBeDisabled
+
+Проверяет, отключен ли элемент с помощью вызова [isEnabled](../element/isEnabled).
+
+Например:
+
+```javascript
+const elem = await browser.$("#elem");
+await expect(elem).toBeDisabled();
+// или, что то же самое:
+await expect(elem).not.toBeEnabled();
+```
+
+## toBeEnabled
+
+Проверяет, включен ли элемент с помощью вызова [isEnabled](../element/isEnabled).
+
+Например:
+
+```javascript
+const elem = await browser.$("#elem");
+await expect(elem).toBeEnabled();
+// или, что то же самое:
+await expect(elem).not.toBeDisabled();
+```
+
+## toBeSelected
+
+Проверяет, выбран ли элемент с помощью вызова [isSelected](../element/isSelected).
+
+Например:
+
+```javascript
+const elem = await browser.$("#elem");
+await expect(elem).toBeSelected();
+```
+
+## toBeChecked
+
+То же, что и [toBeSelected](#tobeselected).
+
+Например:
+
+```javascript
+const elem = await browser.$("#elem");
+await expect(elem).toBeChecked();
+```
+
+## toHaveHref
+
+Проверяет, есть ли заданный адрес у ссылки элемента.
+
+Например:
+
+```javascript
+const link = await browser.$("a");
+await expect(link).toHaveHref("https://webdriver.io");
+```
+
+## toHaveLink
+
+То же, что и [toHaveHref](#tohavehref).
+
+Например:
+
+```javascript
+const link = await browser.$("a");
+await expect(link).toHaveLink("https://webdriver.io");
+```
+
+## toHaveHrefContaining
+
+Проверяет, есть ли заданная подстрока в адресе у ссылки элемента.
+
+Например:
+
+```javascript
+const link = await browser.$("a");
+await expect(link).toHaveHrefContaining("webdriver.io");
+```
+
+## toHaveLinkContaining
+
+То же, что и [toHaveHrefContaining](#tohavehrefcontaining).
+
+Например:
+
+```javascript
+const link = await browser.$("a");
+await expect(link).toHaveLinkContaining("webdriver.io");
+```
+
+## toHaveId
+
+Проверяет, есть ли у элемента заданный ID.
+
+Например:
+
+```javascript
+const elem = await browser.$("#elem");
+await expect(elem).toHaveId("elem");
+```
+
+## toHaveText
+
+Проверяет, совпадает ли текст элемента с заданным значением.
+
+Также может быть вызван с массивом в качестве параметра в случае, когда элемент может иметь разные тексты.
+
+Например:
+
+```javascript
+await browser.url("https://webdriver.io/");
+const elem = await browser.$(".container");
+await expect(elem).toHaveText("Next-gen browser and mobile automation test framework for Node.js");
+await expect(elem).toHaveText([
+    "Next-gen browser and mobile automation test framework for Node.js",
+    "Get Started",
+]);
+```
+
+## toHaveTextContaining
+
+Проверяет, содержит ли текст элемента заданное значение в качестве подтекста.
+
+Также может быть вызван с массивом в качестве параметра в случае, когда элемент может иметь разные тексты.
+
+Например:
+
+```javascript
+await browser.url("https://webdriver.io/");
+const elem = await browser.$(".container");
+await expect(elem).toHaveTextContaining("browser and mobile automation test framework");
+await expect(elem).toHaveTextContaining([
+    "browser and mobile automation test framework",
+    "Started",
+]);
+```
+
+## toBeDisplayedInViewport
+
+Проверяет, находится ли элемент в пределах области просмотра _(viewport)_, используя команду [isDisplayedInViewport](../element/isDisplayedInViewport).
+
+Например:
+
+```javascript
+const elem = await browser.$("#elem");
+await expect(elem).toBeDisplayedInViewport();
+```
+
+## toHaveChildren
+
+Проверяет количество дочерних элементов заданного элемента, используя команду [element.$('./\*')](../element/_dollar).
+
+Например:
+
+```javascript
+const list = await browser.$("ul");
+await expect(list).toHaveChildren(); // в списке есть как минимум 1 элемент
+// или, что то же самое:
+await expect(list).toHaveChildren({ gte: 1 });
+```
+
+```javascript
+await expect(list).toHaveChildren(3); // в списке есть 3 элемента
+// или, что то же самое:
+await expect(list).toHaveChildren({ eq: 3 });
+```
+
+## toBeElementsArrayOfSize
+
+Проверяет количество полученных элементов с помощью команды [$$](../element/_dollardollar).
+
+Например:
+
+```javascript
+const listItems = await browser.$$("ul>li");
+await expect(listItems).toBeElementsArrayOfSize(5); // 5 элементов в списке
+```
+
+```javascript
+await expect(listItems).toBeElementsArrayOfSize({ lte: 10 });
+// или, что то же самое:
+assert.ok(listItems.length <= 10);
+```
diff --git a/docs/commands/expect/mock-matchers.mdx b/docs/commands/expect/mock-matchers.mdx
new file mode 100644
index 0000000..ded9018
--- /dev/null
+++ b/docs/commands/expect/mock-matchers.mdx
@@ -0,0 +1,62 @@
+# expect для моков сети
+
+## toBeRequested
+
+Проверяет, был ли сделан указанный запрос.
+
+Например:
+
+```javascript
+const mock = browser.mock("**/api/todo*");
+await expect(mock).toBeRequested();
+```
+
+## toBeRequestedTimes
+
+Проверяет, был ли сделан указанный запрос ожидаемое количество раз.
+
+Например:
+
+```javascript
+const mock = browser.mock("**/api/todo*");
+await expect(mock).toBeRequestedTimes(2);
+// или, что то же самое:
+await expect(mock).toBeRequestedTimes({ eq: 2 });
+```
+
+```javascript
+const mock = browser.mock("**/api/todo*");
+// проверяем, что запрос был сделан как минимум 5 раз, но не больше 10 раз
+await expect(mock).toBeRequestedTimes({ gte: 5, lte: 10 });
+```
+
+## toBeRequestedWith
+
+Проверяет, был ли сделан указанный запрос с заданными опциями.
+
+Большинство опций поддерживают частичные матчеры _expect.* / jasmine.*_ такие как [expect.objectContaining](https://jestjs.io/docs/expect#expectobjectcontainingobject).
+
+Например:
+
+```javascript
+const mock = browser.mock("**/api/todo*", { method: "POST" });
+
+await expect(mock).toBeRequestedWith({
+    url: "http://localhost:8080/api/todo", // [optional] string | function | custom matcher
+    method: "POST", // [optional] string | array
+    statusCode: 200, // [optional] number | array
+    requestHeaders: { Authorization: "foo" }, // [optional] object | function | custom matcher
+    responseHeaders: { Authorization: "bar" }, // [optional] object | function | custom matcher
+    postData: { title: "foo", description: "bar" }, // [optional] object | function | custom matcher
+    response: { success: true }, // [optional] object | function | custom matcher
+});
+
+await expect(mock).toBeRequestedWith({
+    url: expect.stringMatching(/.*\/api\/.*/i),
+    method: ["POST", "PUT"], // или POST, или PUT
+    statusCode: [401, 403], // или 401, или 403
+    requestHeaders: headers => headers.Authorization.startsWith("Bearer "),
+    postData: expect.objectContaining({ released: true, title: expect.stringContaining("foobar") }),
+    response: r => Array.isArray(r) && r.data.items.length === 20,
+});
+```
diff --git a/docs/commands/mock/abort.mdx b/docs/commands/mock/abort.mdx
new file mode 100644
index 0000000..cbd00af
--- /dev/null
+++ b/docs/commands/mock/abort.mdx
@@ -0,0 +1,48 @@
+# abort
+
+## Обзор {#overview}
+
+Используйте команду `abort`, чтобы прервать запрос с заданной ошибкой.
+
+Запрос можно прервать с одной из следующих ошибок:
+
+-   Failed
+-   Aborted
+-   TimedOut
+-   AccessDenied
+-   ConnectionClosed | ConnectionReset | ConnectionRefused | ConnectionAborted | ConnectionFailed
+-   NameNotResolved
+-   InternetDisconnected
+-   AddressUnreachable
+-   BlockedByClient | BlockedByResponse
+
+## Использование {#usage}
+
+```javascript
+mock.abort(errorCode);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>errorCode</td><td>ErrorCode</td><td>Код ошибки ответа. Возможные значения см. [выше](#overview).</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should block Google Analytics from page", async ({ browser }) => {
+    const mock = await browser.mock("https://www.google-analytics.com/**");
+    mock.abort("Failed");
+});
+```
+
+## Связанные команды {#related}
+
+-   [abortOnce](./abortOnce)
diff --git a/docs/commands/mock/abortOnce.mdx b/docs/commands/mock/abortOnce.mdx
new file mode 100644
index 0000000..759a3d7
--- /dev/null
+++ b/docs/commands/mock/abortOnce.mdx
@@ -0,0 +1,57 @@
+# abortOnce
+
+## Обзор {#overview}
+
+Используйте команду `abortOnce`, чтобы прервать запрос один раз с заданной ошибкой.
+
+Запрос можно прервать с одной из следующих ошибок:
+
+-   Failed
+-   Aborted
+-   TimedOut
+-   AccessDenied
+-   ConnectionClosed | ConnectionReset | ConnectionRefused | ConnectionAborted | ConnectionFailed
+-   NameNotResolved
+-   InternetDisconnected
+-   AddressUnreachable
+-   BlockedByClient | BlockedByResponse
+
+## Использование {#usage}
+
+```javascript
+mock.abortOnce(errorCode);
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>errorCode</td><td>ErrorCode</td><td>Код ошибки ответа. Возможные значения см. [выше](#overview).</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it("should block mock only once", async ({ browser }) => {
+    const mock = await browser.mock("https://webdriver.io");
+    mock.abortOnce("Failed");
+
+    await browser
+        .url("https://webdriver.io")
+        // ловим исключение, так как запрос к странице упадет
+        .catch(() => console.log('Failed to get the page "https://webdriver.io"'));
+
+    await browser.url("https://webdriver.io");
+    console.log(await browser.getTitle());
+    // выведет: "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js"
+});
+```
+
+## Связанные команды {#related}
+
+-   [abort](./abort)
diff --git a/docs/commands/mock/clear.mdx b/docs/commands/mock/clear.mdx
new file mode 100644
index 0000000..516200d
--- /dev/null
+++ b/docs/commands/mock/clear.mdx
@@ -0,0 +1,28 @@
+# clear
+
+## Обзор {#overview}
+
+Используйте команду `clear`, чтобы сбросить всю информацию, хранящуюся в массиве `mock.calls`.
+
+## Использование {#usage}
+
+```javascript
+mock.clear();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it("should clear mock", async ({ browser }) => {
+    const mock = await browser.mock("https://google.com/");
+    await browser.url("https://google.com");
+
+    console.log(mock.calls.length); // выведет: 1
+    mock.clear();
+    console.log(mock.calls.length); // выведет: 0
+});
+```
+
+## Связанные команды {#related}
+
+-   [restore](./restore)
diff --git a/docs/commands/mock/respond.mdx b/docs/commands/mock/respond.mdx
new file mode 100644
index 0000000..23a8a22
--- /dev/null
+++ b/docs/commands/mock/respond.mdx
@@ -0,0 +1,85 @@
+import Admonition from "@theme/Admonition";
+
+# respond
+
+## Обзор {#overview}
+
+Используйте команду `respond`, чтобы всегда отвечать одной и той же перезаписью.
+
+<Admonition type="info">
+    Читайте также рецепт «[Как отслеживать и перехватывать сетевые запросы и
+    ответы][how-to-intercept-requests-and-responses]».
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+mock.respond(overwrites, { header, statusCode, fetchResponse });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>overwrites</td><td>MockOverwrite</td><td>_Payload_ для перезаписи ответа.</td></tr>
+<tr><td>header</td><td>Object</td><td>Перезаписать определенные заголовки.</td></tr>
+<tr><td>statusCode</td><td>Number</td><td>Перезаписать код состояния ответа.</td></tr>
+<tr><td>fetchResponse</td><td>Boolean</td><td>Получить реальный ответ, прежде чем отвечать с помощью поддельных данных.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+it('should demonstrate response overwrite with static data', async ({ browser }) => {
+    const mock = await browser.mock('https://todo-backend-express-knex.herokuapp.com/', {
+        method: 'get'
+    });
+
+    mock.respond([{
+        title: 'Injected (non) completed Todo',
+        order: null,
+        completed: false
+    }, {
+        title: 'Injected completed Todo',
+        order: null,
+        completed: true
+    }], {
+        statusCode: 200,
+        fetchResponse: true // по умолчанию
+    });
+
+    await browser.url('https://todobackend.com/client/index.html?https://todo-backend-express-knex.herokuapp.com/');
+
+    await browser.$('#todo-list li').waitForExist();
+
+    const todoElements = await browser.$$('#todo-list li');
+    console.log(await Promise.all(todoElements.map(el => el.getText())));
+    // выведет: "[ 'Injected (non) completed Todo', 'Injected completed Todo' ]"
+});
+
+it('should demonstrate response overwrite with dynamic data', async ({ browser }) => {
+    const mock = await browser.mock('https://todo-backend-express-knex.herokuapp.com/');
+
+    mock.respond((request) => {
+        if (request.body.username === 'test') {
+            return { ...request.body, foo: 'bar' };
+        }
+        return request.body;
+    }, {
+        statusCode: () => 200,
+        headers: () => ({ foo: 'bar }),
+        fetchResponse: false // не получать настоящий ответ
+    });
+});
+```
+
+## Связанные команды {#related}
+
+-   [respondOnce](./respondOnce)
+
+[how-to-intercept-requests-and-responses]: ../../guides/how-to-intercept-requests-and-responses
diff --git a/docs/commands/mock/respondOnce.mdx b/docs/commands/mock/respondOnce.mdx
new file mode 100644
index 0000000..56b253f
--- /dev/null
+++ b/docs/commands/mock/respondOnce.mdx
@@ -0,0 +1,108 @@
+import Admonition from "@theme/Admonition";
+
+# respondOnce
+
+## Обзор {#overview}
+
+Используйте команду `respondOnce`, чтобы ответить один раз заданной перезаписью.
+
+Вы можете вызвать `respondOnce` несколько раз подряд, тогда при запросах ответы будут использоваться в том же порядке, как были вызваны команды `respondOnce`.
+
+Если вы используете только `respondOnce` и обратитесь к ресурсу большее количество раз, чем вызывали `respondOnce`, то после исчерпания поддельных данных, запрос начнет возвращать оригинальный ответ от ресурса.
+
+<Admonition type="info">
+    Читайте также рецепт «[Как отслеживать и перехватывать сетевые запросы и
+    ответы][how-to-intercept-requests-and-responses]».
+</Admonition>
+
+## Использование {#usage}
+
+```javascript
+mock.respondOnce(overwrites, { header, statusCode, fetchResponse });
+```
+
+## Параметры команды {#parameters}
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>overwrites</td><td>MockOverwrite</td><td>_Payload_ для перезаписи ответа.</td></tr>
+<tr><td>header</td><td>Object</td><td>Перезаписать определенные заголовки.</td></tr>
+<tr><td>statusCode</td><td>Number</td><td>Перезаписать код состояния ответа.</td></tr>
+<tr><td>fetchResponse</td><td>Boolean</td><td>Получить реальный ответ, прежде чем отвечать с помощью поддельных данных.</td></tr>
+
+</tbody>
+</table>
+
+## Примеры использования {#examples}
+
+```javascript
+async function getToDos(browser) {
+    await browser.$("#todo-list li").waitForExist();
+
+    const todoElements = await browser.$$("#todo-list li");
+
+    return Promise.all(todoElements.map(el => el.getText()));
+}
+
+it("should demonstrate the respondOnce command", async ({ browser }) => {
+    const mock = await browser.mock("https://todo-backend-express-knex.herokuapp.com/", {
+        method: "get",
+    });
+
+    mock.respondOnce([
+        {
+            title: "3",
+        },
+        {
+            title: "2",
+        },
+        {
+            title: "1",
+        },
+    ]);
+
+    mock.respondOnce([
+        {
+            title: "2",
+        },
+        {
+            title: "1",
+        },
+    ]);
+
+    mock.respondOnce([
+        {
+            title: "1",
+        },
+    ]);
+
+    await browser.url(
+        "https://todobackend.com/client/index.html?https://todo-backend-express-knex.herokuapp.com/",
+    );
+    console.log(await getToDos(browser)); // выведет: [ '3', '2', '1' ]
+
+    await browser.url(
+        "https://todobackend.com/client/index.html?https://todo-backend-express-knex.herokuapp.com/",
+    );
+    console.log(await getToDos(browser)); // выведет: [ '2', '1' ]
+
+    await browser.url(
+        "https://todobackend.com/client/index.html?https://todo-backend-express-knex.herokuapp.com/",
+    );
+    console.log(await getToDos(browser)); // выведет: [ '1' ]
+
+    await browser.url(
+        "https://todobackend.com/client/index.html?https://todo-backend-express-knex.herokuapp.com/",
+    );
+    console.log(await getToDos(browser)); // выведет: настоящий ответ ресурса
+});
+```
+
+## Связанные команды {#related}
+
+-   [respond](./respond)
+
+[how-to-intercept-requests-and-responses]: ../../guides/how-to-intercept-requests-and-responses
diff --git a/docs/commands/mock/restore.mdx b/docs/commands/mock/restore.mdx
new file mode 100644
index 0000000..8b9df95
--- /dev/null
+++ b/docs/commands/mock/restore.mdx
@@ -0,0 +1,28 @@
+# restore
+
+## Обзор {#overview}
+
+Используйте команду `restore`, чтобы выполнить все то же, что делает [mock.clear()](./clear), а также удалить любые поддельные возвращаемые значения или реализации.
+
+## Использование {#usage}
+
+```javascript
+mock.restore();
+```
+
+## Примеры использования {#examples}
+
+```javascript
+it("should demonstrate the addValue command", async ({ browser }) => {
+    const mock = await browser.mock("**/googlelogo_color_272x92dp.png");
+    mock.respond("https://webdriver.io/img/webdriverio.png");
+
+    await browser.url("https://google.com"); // покажет логотип WebdriverIO вместо логотипа Google
+    mock.restore();
+    await browser.url("https://google.com"); // покажет родной логотип Google
+});
+```
+
+## Связанные команды {#related}
+
+-   [clear](./clear)
diff --git a/docs/commands/overview.mdx b/docs/commands/overview.mdx
new file mode 100644
index 0000000..3f98a4a
--- /dev/null
+++ b/docs/commands/overview.mdx
@@ -0,0 +1,50 @@
+---
+sidebar_class_name: hidden
+---
+
+import Admonition from "@theme/Admonition";
+
+# Команды testplane
+
+## Обзор
+
+<Admonition type="warning">
+    Описаны только команды для последней версии Testplane v8 и WebDriverIO v8. Команды для более
+    старых версий стоит смотреть в документации WebDriverIO (пример для [WebDriverIO
+    v7][webdriverio@7-api]).
+</Admonition>
+
+Так как в основе testplane лежит [WebDriverIO v8][webdriverio-api], то в ней доступны все команды, которые предоставляет WebDriverIO.
+
+Однако, описания команд на сайте [WebDriverIO][webdriverio-api] для 8-й версии не совсем подходят _as is_ для пользователей testplane из-за целого ряда причин:
+
+-   в WebDriverIO объект `browser` существует в глобальном пространстве, тогда как в testplane нужно либо писать `this.browser`:
+
+    ```javascript
+    it("should test something", async () => {
+        const browser = this.browser;
+        // код теста...
+    });
+    ```
+
+    либо получать объект `browser` из аргумента функции (обратите внимание, что объект `browser` передается внутри объекта!):
+
+    ```javascript
+    it("should test something", async ({ browser }) => {
+        // код теста...
+    });
+    ```
+
+-   аналогично функции `browser.$` и `browser.$$` в WebDriverIO доступны в тестах под именами `$` и `$$`, а в testplane к ним нужно обращаться по полному пути: `browser.$` и `browser.$$`;
+
+-   не проставлены связи между похожими командами: нет кластеризации команд;
+
+-   все команды описаны только на английском языке.
+
+Тем не менее в наше описание пока ещё не вошли протоколо-специфичные команды. Соответствующие команды вы можете посмотреть на сайте WebDriverIO в разделе "[Protocols][webdriverio-protocols]".
+
+Также в описаниях некоторых команд ссылки на отдельные рецепты все еще не локализованы и ведут на сайт WebDriverIO.
+
+[webdriverio@7-api]: https://webdriver.io/docs/api
+[webdriverio-api]: https://webdriver.io/docs/api
+[webdriverio-protocols]: https://webdriver.io/docs/api/webdriver
diff --git a/docs/config/browsers.mdx b/docs/config/browsers.mdx
new file mode 100644
index 0000000..4d0bf1c
--- /dev/null
+++ b/docs/config/browsers.mdx
@@ -0,0 +1,654 @@
+import Admonition from "@theme/Admonition";
+
+# browsers
+
+## Обзор {#overview}
+
+Раздел `browsers` является обязательным в настройках Testplane. В нем задаются все браузеры, в которых будут запускаться тесты.
+
+## Настройка {#setup}
+
+Данный раздел имеет следующий формат:
+
+```javascript
+module.exports = {
+    browsers: {
+        <browser-id>: {
+            <option>: <value>,
+            <option>: <value>,
+
+            // остальные настройки браузера...
+        },
+
+        // другие браузеры...
+    },
+
+    // остальные настройки Testplane...
+}
+```
+
+Где `<browser-id>` — это имя браузера, которое используется для его идентификации.
+
+Чтобы не повторять одни и те же настройки для разных браузеров, вы можете задать все нужные вам значения по умолчанию в корне конфига Testplane. Например:
+
+```javascript
+module.exports = {
+    sessionsPerBrowser: 10,
+    browsers: {
+        chrome: {
+            // параметр sessionsPerBrowser не указан,
+            // поэтому будет использовано значение 10 из корня конфига
+        },
+
+        firefox: {
+            sessionsPerBrowser: 5, // а firefox будет использовать значение 5
+        },
+    },
+
+    // остальные настройки Testplane...
+};
+```
+
+Далее все настройки браузера разбиты логически по разделам, чтобы среди них было проще ориентироваться.
+
+## Браузер и его свойства {#browser_main_settings}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[desiredCapabilities](#desired_caps)</td><td>Object</td><td>_N/A_</td><td>Обязательный параметр. Определяет свойства, которыми должен обладать браузер. Используется _WebDriver'ом_, см. [DesiredCapabilities][desired-caps].</td></tr>
+<tr><td>[gridUrl](#grid_url)</td><td>String</td><td>"http://localhost:4444/wd/hub"</td><td>URL грида Selenium.</td></tr>
+<tr><td>[baseUrl](#base_url)</td><td>String</td><td>"http://localhost"</td><td>Базовый URL тестируемого сервиса.</td></tr>
+<tr><td>[browserWSEndpoint](#browser_ws_endpoint)</td><td>String</td><td>null</td><td>Эндпойнт websocket-соединения для подключения к браузеру через [Chrome DevTools Protocol (CDP)][how-to-use-cdp].</td></tr>
+<tr><td>[automationProtocol](#automation_protocol)</td><td>String</td><td>"webdriver"</td><td>Протокол общения с браузером. См. [WebDriver vs CDP](../reference/webdriver-vs-cdp).</td></tr>
+<tr><td>[sessionEnvFlags](#session_env_flags)</td><td>Object</td><td>`{ }`</td><td>Флаги окружения, задающие протокол, который будет использоваться в созданной сессии браузера.</td></tr>
+<tr><td>[windowSize](#window_size)</td><td>String или Object</td><td>null</td><td>Размеры окна браузера.</td></tr>
+
+</tbody>
+</table>
+
+### desiredCapabilities {#desired_caps}
+
+Обязательный параметр. Определяет свойства, которыми должен обладать браузер. Используется _WebDriver'ом_, см. [DesiredCapabilities][desired-caps]. Например:
+
+```javascript
+module.exports = {
+    browsers: {
+        chrome: {
+            desiredCapabilities: {
+                browserName: "chrome",
+                version: "75.0", // или "browserVersion", если браузер поддерживает W3C
+                chromeOptions: {
+                    // ...
+                },
+            },
+        },
+
+        // настройки других браузеров...
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+### gridUrl {#grid_url}
+
+URL грида Selenium. По умолчанию: `http://localhost:4444/wd/hub`.
+
+### baseUrl {#base_url}
+
+Базовый URL тестируемого сервиса. По умолчанию: `http://localhost`.
+
+### browserWSEndpoint {#browser_ws_endpoint}
+
+Эндпойнт websocket-соединения для подключения к браузеру через [Chrome DevTools Protocol (CDP)][how-to-use-cdp]. Например, вы указываете `browserWSEndpoint: "ws://YOUR_HOST/devtools"`, к которому в конце будет добавлен идентификатор сеанса браузера: `ws://YOUR_HOST/devtools/12345`, где `12345` — это идентификатор сеанса.
+
+Значение по умолчанию: `null`. Означает, что WebDriverIO попытается самостоятельно определить эндпойнт для веб-сокета.
+
+### automationProtocol {#automation_protocol}
+
+Протокол общения с браузером. Доступные значения: `webdriver` и `devtools`. См. также [WebDriver vs CDP](../reference/webdriver-vs-cdp). По умолчанию: `webdriver`.
+
+### sessionEnvFlags {#session_env_flags}
+
+Флаги окружения задают протоколы, которые будут использоваться в созданной сессии браузера. По умолчанию флаги окружения автоматически устанавливаются в соответствии с заданными `desiredCapabilities`. Однако в редких случаях они могут принимать некорректные значения и тогда с помощью этой опции их можно будет задать явно.
+
+Доступные флаги:
+
+<table>
+<thead>
+<tr><td>**Флаг**</td><td>**Протоколы**</td></tr>
+</thead>
+<tbody>
+<tr><td>isW3C</td><td>[WebDriverProtocol](https://webdriver.io/docs/api/webdriver) или по умолчанию [JsonWProtocol](https://webdriver.io/docs/api/jsonwp)</td></tr>
+<tr><td>isChrome</td><td>[ChromiumProtocol](https://webdriver.io/docs/api/chromium)</td></tr>
+<tr><td>isMobile</td><td>[MJsonWProtocol](https://webdriver.io/docs/api/mjsonwp) и [AppiumProtocol](https://webdriver.io/docs/api/appium)</td></tr>
+<tr><td>isSauce</td><td>[Команды конкретного поставщика Sauce Labs](https://webdriver.io/docs/api/saucelabs)</td></tr>
+<tr><td>isSeleniumStandalone</td><td>[Специальные команды для Selenium](https://webdriver.io/docs/api/selenium) при запуске тестов в _Selenium Grid_ или с помощью _Selenium Standalone Server_.</td></tr>
+
+</tbody>
+</table>
+
+Например:
+
+```javascript
+module.exports = {
+    browsers: {
+        chrome: {
+            sessionEnvFlags: {
+                isW3C: true,
+                isChrome: true,
+            },
+        },
+
+        // настройки других браузеров...
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+### windowSize {#window_size}
+
+Размеры окна браузера. Если не указывать, то размер окна будет зависеть от WebDriver'а. Можно указывать как строку, например, `800x1000` или как объект с ключами `width` и `height`, значениями которых нужно указать целые числа.
+
+Например:
+
+```javascript
+windowSize: "800x1000";
+```
+
+и
+
+```javascript
+windowSize: {
+  width: 800,
+  height: 1000
+}
+```
+
+эквивалентны между собой.
+
+<Admonition type="warning">
+    Настройка разрешения для браузера Opera или для мобильных браузеров не работает. Так как эти
+    браузеры используют только полноэкранный режим.
+</Admonition>
+
+## Таймауты {#timeouts}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[waitTimeout](#wait_timeout)</td><td>Number</td><td>3000</td><td>Таймаут для событий на веб-странице, в мс.</td></tr>
+<tr><td>[waitInterval](#wait_interval)</td><td>Number</td><td>500</td><td>Интервал для событий на веб-странице, в мс.</td></tr>
+<tr><td>[httpTimeout](#http_timeout)</td><td>Number</td><td>30000</td><td>Таймаут для любых запросов к Selenium-серверу, в мс.</td></tr>
+<tr><td>[urlHttpTimeout](#url_http_timeout)</td><td>Number</td><td>= _httpTimeout_</td><td>Таймаут для запроса _/url_ к Selenium-серверу, в мс.</td></tr>
+<tr><td>[pageLoadTimeout](#page_load_timeout)</td><td>Number</td><td>20000</td><td>Таймаут для полной загрузки страницы, в мс.</td></tr>
+<tr><td>[sessionRequestTimeout](#session_request_timeout)</td><td>Number</td><td>= _httpTimeout_</td><td>Таймаут запроса сессии браузера, в мс.</td></tr>
+<tr><td>[sessionQuitTimeout](#session_quit_timeout)</td><td>Number</td><td>5000</td><td>Таймаут для завершения сессии, в мс.</td></tr>
+<tr><td>[testTimeout](#test_timeout)</td><td>Number</td><td>null</td><td>Таймаут для прогона теста, в мс. Если значение не задано, то будет использован общий таймаут для всех браузеров, который задается настройкой [system.mochaOpts.timeout][system-mocha-opts].</td></tr>
+
+</tbody>
+</table>
+
+### waitTimeout {#wait_timeout}
+
+Таймаут для событий на веб-странице, в миллисекундах. По умолчанию: `3000` мс (3 секунды).
+
+Применяется в команде [waitUntil][element-wait-until], которая используется во всех `waitFor*`-командах при поиске заданного элемента на странице.
+
+Например, при выполнении команды `browser.$('.element').click()` подкоманда `$('element')` будет по умолчанию ждать существования элемента до 3000 мс, прежде чем кликнуть по нему.
+
+### waitInterval {#wait_interval}
+
+Интервал для событий на веб-странице, в миллисекундах. По умолчанию: `500` мс.
+
+Применяется в команде [waitUntil][element-wait-until], которая используется во всех `waitFor*`-командах при поиске заданного элемента на странице.
+
+Например, при выполнении команды `browser.$('.element').click()` подкоманда `$('element')` будет по умолчанию проверять существование элемента каждые 500 мс.
+
+### httpTimeout {#http_timeout}
+
+Таймаут для любых запросов к Selenium-серверу, в миллисекундах. По умолчанию: `30000` мс.
+
+### urlHttpTimeout {#url_http_timeout}
+
+Таймаут для запроса `/url` к Selenium-серверу, в миллисекундах. Иногда при открытии ссылки на стороне сервера выполняется масса логики в мидлварах, из-за чего ссылка долго открывается. Чтобы не поднимать из-за этого таймаут для всех команд, Testplane позволяет настроить отдельный таймаут для запроса `/url`.
+
+### pageLoadTimeout {#page_load_timeout}
+
+Таймаут для полной загрузки страницы, в миллисекундах. По умолчанию: `20000` мс.
+
+### sessionRequestTimeout {#session_request_timeout}
+
+Таймаут запроса сессии браузера, в миллисекундах. По умолчанию берет значение настройки `httpTimeout`.
+
+### sessionQuitTimeout {#session_quit_timeout}
+
+Таймаут для завершения сессии, в миллисекундах. По умолчанию: `5000` мс.
+
+### testTimeout {#test_timeout}
+
+Таймаут для прогона теста, в миллисекундах. При использовании для набора тестов _(suite),_ будет применяться для всех тестов и хуков внутри этого набора тестов.
+
+Если значение не задано, то будет использован общий таймаут для всех браузеров, который задается настройкой [system.mochaOpts.timeout][system-mocha-opts].
+
+## Запуск тестов {#test_run_settings}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[sessionsPerBrowser](#sessions_per_browser)</td><td>Number</td><td>1</td><td>Число сессий, которые будут запущены одновременно для конкретного браузера.</td></tr>
+<tr><td>[testsPerSession](#tests_per_session)</td><td>Number</td><td>_N/A_</td><td>Сколько тестов можно запускать последовательно в одной сессии браузера. Параметр ограничивает переиспользование сессии, чтобы не допустить падения тестов из-за деградации браузера, и не имеет отношения к параллельному запуску тестов.</td></tr>
+<tr><td>[retry](#retry)</td><td>Number</td><td>0</td><td>Сколько раз нужно перезапускать падающий тест.</td></tr>
+<tr><td>[shouldRetry](#should_retry)</td><td>Function</td><td>_см. описание_</td><td>Функция, которая определяет нужен ли ретрай. По умолчанию задается функция, которая возвращает _true_, если _retry > 0,_ и _false_, если _retry == 0_.</td></tr>
+<tr><td>[strictTestsOrder](#strict_test_order)</td><td>Boolean</td><td>false</td><td>Гарантировать строгий порядок тестов. Если _true_, то функция API _testplane.readTests_ будет всегда возвращать один и тот же результат.</td></tr>
+
+</tbody>
+</table>
+
+### sessionsPerBrowser {#sessions_per_browser}
+
+Число сессий, которые будут запущены одновременно для конкректного браузера. По умолчанию: `1`.
+
+### testsPerSession {#tests_per_session}
+
+Параметр определяет сколько тестов можно запускать последовательно в одной сессии браузера. Может быть полезно, чтобы ограничить переиспользование сессии. Если одну и ту же сессию браузера использовать много раз для прогона различных тестов, то в какой-то момент браузер может начать деградировать. И это начнет влиять на прогон тестов, приводя к их падениям. После того как будет достигнут лимит тестов, сессия будет закрыта и запустится новая сессия.
+
+По умолчанию: `Infinity`. То есть сессия будет переиспользована бесконечное число раз. Однако в реальной эксплуатации возможны ограничения со стороны грида, в рамках которого запускаются браузеры. Например, грид может ограничивать со своей стороны максимальное время жизни одной сессии, и тогда количество тестов, которые окажутся выполненными в рамках одной сессии, будет определяться временем её жизни.
+
+<Admonition type="warning">
+    Будьте внимательны: данный параметр не имеет отношения к параллельному запуску тестов.
+</Admonition>
+
+### retry {#retry}
+
+Сколько раз нужно запустить тест снова, если он будет падать. По умолчанию: `0`.
+
+### shouldRetry {#should_retry}
+
+Функция, которая определяет нужен ли ретрай. Должна возвращать значение типа `Boolean`. По умолчанию задается функция, которая возвращает `true`, если ещё остались доступные ретраи, и `false`, если достигнут предел ретраев для теста (см. настройку [retry](#retry)).
+
+Аргументом данной функции является объект со следующими полями:
+
+<table>
+<thead>
+<tr><td>ctx</td><td>Object</td><td>Данные об упавшем тесте: _\{ id(): string; browserId: string; sessionId: string; }_.</td></tr>
+</thead>
+<tbody>
+<tr><td>retriesLeft</td><td>Number</td><td>Число оставшихся ретраев</td></tr>
+
+</tbody>
+</table>
+
+### strictTestsOrder {#strict_test_order}
+
+Данная опция включает гарантию строгого порядка чтения тестов. По умолчанию: `false`.
+
+## Информация о тесте и падении {#info_when_test_fails}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[meta](#meta)</td><td>Object</td><td>_N/A_</td><td>Дополнительные данные, которые будут возвращаться командой _getMeta()_.</td></tr>
+<tr><td>[takeScreenshotOnFails](#take_screenshot_on_fails)</td><td>Object</td><td>_см. описание_</td><td>Определяет снимать ли скриншот страницы браузера _(Page Screenshot)_ при падении теста, а также при падении команды _assertView_. Значение по умолчанию: _\{ testFail: true, assertViewFail: true }_.</td></tr>
+<tr><td>[takeScreenshotOnFailsMode](#take_screenshot_on_fails_mode)</td><td>String</td><td>"fullpage"</td><td>Режим снятия скриншота при падении теста. Доступные значения: _viewport_ и _fullpage_.</td></tr>
+<tr><td>[takeScreenshotOnFailsTimeout](#take_screenshot_on_fails_timeout)</td><td>Number</td><td>5000</td><td>Таймаут для снятия скриншота страницы браузера _(Page Screenshot)_ при падении теста, в мс.</td></tr>
+<tr><td>[saveHistory](#save_history)</td><td>Boolean</td><td>true</td><td>Сохранять историю всех выполненных команд. _В hermione@7 заменена на `saveHistoryMode`_.</td></tr>
+<tr><td>[saveHistoryMode](#save_history_mode)</td><td>"all" или "none" или "onlyFailed"</td><td>"all"</td><td>Сохранять историю всех выполненных команд. _Доступна с hermione@7_.</td></tr>
+
+</tbody>
+</table>
+
+### meta {#meta}
+
+Дополнительные данные, которые будут возвращаться командой `getMeta()`. Данные можно добавлять также «на лету» с помощью команды `setMeta()`: до, во время или после завершения прогона теста.
+
+### takeScreenshotOnFails {#take_screenshot_on_fails}
+
+Опция задается в виде объекта с двумя ключами: `testFail` и `assertViewFail`. Данные ключи определяют нужно ли снимать скриншот страницы браузера _(Page Screenshot)_ при падении теста и при падении команды `assertView` соответственно. Значение по умолчанию: `{ testFail: true, assertViewFail: true }`. В случае `testFail` учитываются все падения тестов кроме падений из-за команд `assertView`.
+
+### takeScreenshotOnFailsMode {#take_screenshot_on_fails_mode}
+
+Режим снятия скриншота страницы браузера при падении теста. Доступные значения: `viewport` и `fullpage`:
+
+-   `viewport` — снять скриншот текущего вьюпорта.
+-   `fullpage` — снять скриншот всей страницы браузера.
+
+По умолчанию: `fullpage`.
+
+### takeScreenshotOnFailsTimeout {#take_screenshot_on_fails_timeout}
+
+Таймаут для снятия скриншота страницы браузера при падении теста, в миллисекундах. По умолчанию: `5000` мс.
+
+### saveHistory {#save_history}
+
+<Admonition type="warning">
+    В hermione@7 заменена на [saveHistoryMode](#save_history_mode).
+</Admonition>
+
+Сохранять историю всех выполненных команд. По умолчанию: `true`.
+
+Некоторые плагины могут полагаться на эту историю, например, [html-reporter][html-reporter].
+
+История доступна из следующих событий — `TEST_END`, `TEST_PASS`, `TEST_FAIL` — через `payload`:
+
+```javascript
+// пример кода плагина
+module.exports = testplane => {
+    testplane.on(testplane.events.TEST_PASS, async test => {
+        console.log(test.history);
+    });
+};
+```
+
+### saveHistoryMode {#save_history_mode}
+
+<Admonition type="warning">Доступна с hermione@7.</Admonition>
+
+Сохранять историю всех выполненных команд. По умолчанию: `all`.
+
+Available options:
+
+-   `all` — история включена.
+-   `none` — история отключена.
+-   `onlyFailed` — история сохраняется только для упавших тестов.
+
+Некоторые плагины могут полагаться на эту историю, например, [html-reporter][html-reporter].
+
+История доступна из следующих событий — `TEST_END`, `TEST_PASS`, `TEST_FAIL` — через `payload`:
+
+```javascript
+// sample plugin code
+module.exports = testplane => {
+    testplane.on(testplane.events.TEST_PASS, async test => {
+        console.log(test.history);
+    });
+};
+```
+
+## Подготовка к снятию скриншотов {#prepare_to_take_screenshot}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[calibrate](#calibrate)</td><td>Boolean</td><td>false</td><td>Выполнять калибровку перед снятием скриншота.</td></tr>
+<tr><td>[orientation](#orientation)</td><td>String</td><td>null</td><td>Ориентация окна браузера, которую нужно выставлять перед запуском каждого теста.</td></tr>
+<tr><td>[waitOrientationChange](#wait_orientation_change)</td><td>Boolean</td><td>true</td><td>Ждать реальной смены ориентации.</td></tr>
+<tr><td>[resetCursor](#reset_cursor)</td><td>Boolean</td><td>true</td><td>Перемещать курсор в точку _(0, 0)_ в координатах _body_ перед каждым запуском теста.</td></tr>
+<tr><td>[screenshotsDir](#screenshots_dir)</td><td>String</td><td>"./testplane/screens"</td><td>Папка для сохранения эталонных скриншотов командой _assertView_. По умолчанию _testplane/screens_ относительно рабочей папки: _process.cwd()_.</td></tr>
+
+</tbody>
+</table>
+
+### calibrate {#calibrate}
+
+Выполнять калибровку перед снятием скриншота. В некоторых реализациях WebDriver'а при снятии скриншота на изображение могут попадать элементы UI самого браузера. Калибровка позволяет решить данную проблему. По умолчанию: `false`.
+
+### orientation {#orientation}
+
+Ориентация окна браузера, которую нужно выставлять перед запуском каждого теста. Доступные значения: `landscape`, `portrait`, `null`. По умолчанию: `null`.
+
+<Admonition type="tip" title="Какое значение выбрать для orientation?">
+    Это зависит от того, в какой ориентации у вас выполняется большинство тестов. Если большая часть
+    тестов у вас выполняется в режиме _landscape,_ то и значение _orientation_ нужно выставлять в
+    _landscape._ Тогда тесты, которым нужна ориентация _portrait,_ будут самостоятельно выставлять
+    нужную им ориентацию. А опция _orientation_ будет гарантировать, что для всех остальных тестов
+    ориентация будет выставлена в _landscape_ автоматически перед их запуском, без необходимости
+    задавать её в каждом тесте самостоятельно.
+</Admonition>
+
+### waitOrientationChange {#wait_orientation_change}
+
+Ждать реальной смены ориентации. По умолчанию: `true`. При установке в значение `true` testplane гарантирует, что команда задания ориентации `setOrientation` будет завершаться только после реального изменения ориентации на заданную.
+
+### resetCursor {#reset_cursor}
+
+Перемещать курсор в точку _(0, 0)_ в координатах _body_ перед каждым запуском теста. По умолчанию: `true`. Может потребоваться в тех случаях, когда положение курсора по умолчанию влияет на выполнение тестов. Например, когда из-за курсора всплывает какая-нибудь подсказка _(hint)_, которая «портит» снимаемый скриншот.
+
+<Admonition type="tip">
+    Рекомендуется сбрасывать курсор для десктопных браузеров и не сбрасывать для мобильных.
+</Admonition>
+
+### screenshotsDir {#screenshots_dir}
+
+Папка для сохранения эталонных скриншотов командой `assertView`. По умолчанию это папка `testplane/screens` относительно рабочей папки: `process.cwd()`. Значением данной опции может быть также функция, которой передается один аргумент — инстанс теста, внутри которого была вызвана команда `assertView`, например:
+
+```javascript
+screenshotsDir: test => `tests/screenshots/${test.parent.title}`;
+```
+
+## Снятие и сравнение скриншотов {#taking_screenshots}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[tolerance](#tolerance)</td><td>Number</td><td>2.3</td><td>Максимально разрешенная разница [CIEDE2000](http://en.wikipedia.org/wiki/Color_difference#CIEDE2000) между цветами.</td></tr>
+<tr><td>[antialiasingTolerance](#antialiasing_tolerance)</td><td>Number</td><td>4</td><td>Задает чувствительность определения антиалиасинга, который будет игнорироваться при сравнении скриншотов.</td></tr>
+<tr><td>[compareOpts](#compare_opts)</td><td>Object</td><td>_[см. ниже](#compare_opts)_</td><td>Опции для сравнения изображений.</td></tr>
+<tr><td>[buildDiffOpts](#build_diff_opts)</td><td>Object</td><td>_[см. ниже](#build_diff_opts)_</td><td>Опции для построения диффа (изображения с разницей между скриншотами).</td></tr>
+<tr><td>[assertViewOpts](#assert_view_opts)</td><td>Object</td><td>_[см. ниже](#assert_view_opts)_</td><td>Опции для команды _assertView_, которые будут использоваться по умолчанию.</td></tr>
+<tr><td>[compositeImage](#composite_image)</td><td>Boolean</td><td>true</td><td>Позволяет тестировать элементы, не влезающие во вьюпорт по высоте.</td></tr>
+<tr><td>[screenshotMode](#screenshot_mode)</td><td>String</td><td>"auto"</td><td>Режим снятия скриншота. Возможные значения: _auto, fullpage, viewport_.</td></tr>
+<tr><td>[screenshotDelay](#screenshot_delay)</td><td>Number</td><td>0</td><td>Задержка перед снятием скриншота, в мс.</td></tr>
+
+</tbody>
+</table>
+
+### tolerance {#tolerance}
+
+Максимально разрешенная разница [CIEDE2000](http://en.wikipedia.org/wiki/Color_difference#CIEDE2000) между цветами. Используется только в нестрогом режиме. По умолчанию `2.3`. Начиная со значения `2.3` разница в цветах становится уже различимой человеческим глазом. Чем меньше это значение, тем строже будет сравнение скриншотов.
+
+Не рекомендуется увеличивать значение `tolerance` на глобальном уровне. Попробуйте вместо этого задавать `tolerance` для конкретных наборов тестов или состояний.
+
+Например, если нужно снять скриншот для конкретного состояния с индивидуальной настройкой `tolerance`:
+
+```javascript
+it("some-test", async function (browser) {
+    await browser.assertView("some-state", ".selector1", { tolerance: 10 });
+    await browser.assertView("another-state", ".selector1");
+});
+```
+
+### antialiasingTolerance {#antialiasing_tolerance}
+
+Задает чувствительность определения антиалиасинга, который будет игнорироваться при сравнении скриншотов.
+
+Читайте подробнее об этой опции в пакете [looks-same](https://github.com/gemini-testing/looks-same#comparing-images-with-ignoring-antialiasing).
+
+### compareOpts {#compare_opts}
+
+Дополнительные опции для сравнения изображений. Смотрите в документации пакета [looks-same](https://github.com/gemini-testing/looks-same#comparing-images) список доступных опций. По умолчанию:
+
+```javascript
+compareOpts: {
+    shouldCluster: false,
+    clustersSize: 10,
+    stopOnFirstFail: false
+}
+```
+
+### buildDiffOpts {#build_diff_opts}
+
+Дополнительные опции для построения диффа (изображения с разницей между скриншотами). Смотрите в документации пакета [looks-same](https://github.com/gemini-testing/looks-same#building-diff-image) список доступных опций. По умолчанию:
+
+```javascript
+buildDiffOpts: {
+    ignoreAntialiasing: true,
+    ignoreCaret: true
+}
+```
+
+### assertViewOpts {#assert_view_opts}
+
+Опции для команды снятия и сравнения скриншотов `assertView`, которые будут использоваться по умолчанию. Могут быть перезаписаны при вызове команды `assertView`. По умолчанию:
+
+```javascript
+assertViewOpts: {
+    ignoreElements: [],
+    captureElementFromTop: true,
+    allowViewportOverflow: false
+}
+```
+
+Всего доступны следующие опции для `assertView`:
+
+<table>
+<thead>
+<tr><td>**Опция**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>ignoreElements</td><td>Array или String</td><td>Элементы (задаются как селекторы), которые будут проигнорированы при сравнении скриншотов. Игнор реализуется с помощью закраски перечисленных элементов черным цветом. В случае одного элемента параметр можно задавать как строку.</td></tr>
+<tr><td>tolerance</td><td>Number</td><td>Чувствительность к разнице в цветам. Значение перетирает [browsers.tolerance](#tolerance).</td></tr>
+<tr><td>antialiasingTolerance</td><td>Number</td><td>Чувствительность в антиалиасинге. Значение перетирает [browsers.antialiasingTolerance](#antialiasing_tolerance).</td></tr>
+<tr><td>allowViewportOverflow</td><td>Boolean</td><td>По умолчанию testplane выдает ошибку, если элемент находится за пределами границ вьюпорта. Этот параметр отключает проверку на границы, позволяя снимать скриншоты элементов, не влезающих во вьюпорт. При этом на скриншоте будут видны только те части элемента, которые влезли во вьюпорт. Однако если _compositeImage_ равен _true_, то части элемента, которые оказались за _нижней_ границей вьюпорта, тоже будут видны на скриншоте. Аналогично если _captureElementFromTop_ равен _true_, то на скриншот попадут и те части элемента, которые оказались за пределами _верхней_ границы вьюпорта.</td></tr>
+<tr><td>captureElementFromTop</td><td>Boolean</td><td>Снимать скриншот элемента с самого верха. Если элемент находится за пределами вьюпорта, то к нему будет выполнен подскролл.</td></tr>
+<tr><td>compositeImage</td><td>Boolean</td><td>Позволяет тестировать элементы, не влезающие во вьюпорт по высоте.</td></tr>
+<tr><td>screenshotDelay</td><td>Number</td><td>Задержка в миллисекундах перед снятием скриншота. Может пригодиться, когда на странице есть элементы, использующие анимацию, или скроллбар, который исчезает не сразу и попадает на результирующий скриншот.</td></tr>
+<tr><td>selectorToScroll</td><td>String</td><td>Селектор, который нужно скроллировать. Может пригодиться, когда надо сделать скриншот модального окна, которое не помещается на экране. Иначе без указания селектора скролл будет применяться к объекту _window_, и скроллироваться будет задний фон, оставляя попап-окно на месте.</td></tr>
+
+</tbody>
+</table>
+
+### compositeImage {#composite_image}
+
+Позволяет тестировать элементы, не влезающие во вьюпорт по высоте. По умолчанию: `true`. Если тестируемый блок по высоте больше вьюпорта, то происходит склеивание изображений нескольких вьюпортов в одно изображение.
+
+### screenshotMode {#screenshot_mode}
+
+Режим снятия скриншотов. По умолчанию: `auto`.
+
+Возможные значения:
+
+<table>
+<thead>
+<tr><td>auto</td><td>режим будет определен автоматически</td></tr>
+</thead>
+<tbody>
+<tr><td>fullpage</td><td>будет снят скриншот всей страницы</td></tr>
+<tr><td>viewport</td><td>будет снят скриншот только вьюпорта</td></tr>
+
+</tbody>
+</table>
+
+По умолчанию для android-браузеров выставляется режим `viewport`, чтобы обойти [багу в Chromium](https://bugs.chromium.org/p/chromedriver/issues/detail?id=2853).
+
+В десктопных браузерах _прямо из коробки_ есть возможность получить изображение всей страницы, а не только видимого вьюпорта. При этом не нужно вручную склеивать изображения отдельных вьюпортов в один большой скриншот. Однако на мобильных устройствах такой функциональности нет.
+
+### screenshotDelay {#screenshot_delay}
+
+Задержка в миллисекундах перед снятием скриншота. По умолчанию: `0` мс. Задержка может пригодиться в тех случаях, когда на странице есть элементы, использующие анимацию, или скроллбар, который исчезает не сразу и попадает на результирующий скриншот.
+
+## Параметры запросов и ответов {#params_of_requests_and_responses}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[agent](#agent)</td><td>Object</td><td>null</td><td>Позволяет задать свои [агенты][got-agent] для запросов по _http, https, http2_.</td></tr>
+<tr><td>[headers](#headers)</td><td>Object</td><td>null</td><td>Позволяет настроить [заголовки][got-headers], которые будут передаваться в каждом запросе к WebDriver.</td></tr>
+<tr><td>[transformRequest](#transform_request)</td><td>Function</td><td>null</td><td>Позволяет перехватывать и преобразовывать [опции][got-options] http-запроса перед запросом к WebDriver.</td></tr>
+<tr><td>[transformResponse](#transform_response)</td><td>Function</td><td>null</td><td>Позволяет перехватывать и преобразовывать [http-ответ][got-response], полученный от WebDriver.</td></tr>
+<tr><td>[strictSSL](#strict_ssl)</td><td>Boolean</td><td>null</td><td>Должен ли SSL-сертификат быть действительным. Если _true_, то это означает, что будет использовано [значение по умолчанию][strict-ssl] от WebDriverIO.</td></tr>
+
+</tbody>
+</table>
+
+### agent {#agent}
+
+Позволяет задать свои [агенты][got-agent] для запросов по _http, https, http2_. По умолчанию: `null` (в таком случае будут использованы дефолтные http-агенты пакета [got][got]).
+
+### headers {#headers}
+
+Позволяет настроить [заголовки][got-headers], которые будут передаваться в каждом запросе к WebDriver. По умолчанию: `null`. Смотрите также в [документации](https://webdriver.io/docs/options/#headers) `WebDriverIO`.
+
+<Admonition type="warning">
+    Данные заголовки не передаются в запрос к браузеру, в котором выполняются тесты. Они передаются
+    только в запросах к WebDriver.
+</Admonition>
+
+### transformRequest {#transform_request}
+
+Позволяет перехватывать и преобразовывать [опции][got-options] http-запроса перед запросом к WebDriver. По умолчанию: `null`. Если передается функция, то первым аргументом ей будет передан объект `RequestOptions`. В ответ функция должна будет вернуть модифицированный `RequestOptions`.
+
+Тип функции:
+
+```javascript
+RequestOptions => RequestOptions;
+```
+
+### transformResponse {#transform_response}
+
+Позволяет перехватывать и преобразовывать [http-ответ][got-response], полученный от WebDriver. По умолчанию: `null`. Если передается функция, то первым аргументом ей будет передан объект `Response`, а вторым — `RequestOptions`. В ответ функция должна будет вернуть модифицированный `Response`.
+
+Тип функции:
+
+```javascript
+(Response, RequestOptions) => Response;
+```
+
+### strictSSL {#strict_ssl}
+
+Должен ли SSL-сертификат быть действительным. Если `true`, то это означает, что будет использовано [значение по умолчанию][strict-ssl] от WebDriverIO.
+
+## Облачные настройки {#cloud_settings}
+
+Следующие настройки могут пригодиться, если вы захотите запускать свои testplane-тесты в браузерах облачных сервисов.
+
+Примером такого облачного сервиса может быть [SauceLabs][sauce-labs], который [может предоставить](https://saucelabs.com/platform/cross-browser-testing) вам как десктопные, так и мобильные браузеры для запуска тестов в них.
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>user</td><td>String</td><td>null</td><td>Имя пользователя в облачном сервисе.</td></tr>
+<tr><td>key</td><td>String</td><td>null</td><td>Ключ доступа или секретный ключ для доступа в облачный сервис.</td></tr>
+<tr><td>region</td><td>String</td><td>null</td><td>Позволяет выбрать различные датацентры в облачном сервисе.</td></tr>
+<tr><td>headless</td><td>String</td><td>null</td><td>Позволяет запускать headless-браузер в облачном сервисе.</td></tr>
+
+</tbody>
+</table>
+
+### user {#user}
+
+Имя пользователя в облачном сервисе. По умолчанию: `null`.
+
+### key {#key}
+
+Ключ доступа или секретный ключ для доступа в облачный сервис. По умолчанию: `null`.
+
+### region {#region}
+
+Позволяет выбрать различные датацентры в облачном сервисе. По умолчанию: `null`.
+
+### headless {#headless}
+
+Позволяет запускать headless-браузер в облачном сервисе. По умолчанию: `null`.
+
+[desired-caps]: https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities
+[html-reporter]: ../html-reporter/html-reporter-setup
+[got]: https://github.com/sindresorhus/got/
+[got-agent]: https://github.com/sindresorhus/got/blob/main/documentation/2-options.md#agent
+[got-headers]: https://github.com/sindresorhus/got/blob/main/documentation/2-options.md#headers
+[got-options]: https://github.com/sindresorhus/got/blob/main/documentation/2-options.md
+[got-response]: https://github.com/sindresorhus/got/blob/main/documentation/3-streams.md#response-2
+[strict-ssl]: https://webdriver.io/docs/options/#strictssl
+[read-tests]: ./browsers
+[sauce-labs]: https://saucelabs.com
+[system-mocha-opts]: ./system#mocha_opts
+[element-wait-until]: ../commands/element/waitUntil
+[how-to-use-cdp]: ../guides/how-to-use-cdp
diff --git a/docs/config/main.mdx b/docs/config/main.mdx
new file mode 100644
index 0000000..6056e69
--- /dev/null
+++ b/docs/config/main.mdx
@@ -0,0 +1,106 @@
+---
+sidebar_class_name: hidden
+---
+
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+# Конфиг Testplane
+
+## Настройка {#setup}
+
+Чтобы настроить Testplane, используйте конфигурационный файл следующего формата:
+
+<Tabs>
+<TabItem value="Минимальный конфиг" label="Минимальный конфиг">
+```javascript
+  module.exports = {
+      browsers: {
+          chrome: {
+              desiredCapabilities: {
+                  browserName: 'chrome',
+
+                  // ...
+              },
+
+              // другие настройки браузера chrome...
+          },
+
+          // настройки других браузеров...
+      }
+
+};
+
+````
+</TabItem>
+
+
+<TabItem value="Максимальный конфиг" label="Максимальный конфиг">
+```javascript
+module.exports = {
+    // глобальные настройки браузеров...
+
+    browsers: {
+        // настройки конкретных браузеров...
+    },
+    sets: {
+        // настройки групп тестов...
+        // группы тестов можно использовать, например,
+        // для разделения запуска десктопных и мобильных тестов
+    },
+    system: {
+        // системные настройки...
+    },
+    plugins: {
+        // подключение внешних плагинов Testplane...
+    },
+    prepareBrowser: function(browser) {
+        // здесь можно добавить новые команды к объекту browser,
+        // где browser - это сессия WebdriverIO
+    },
+    prepareEnvironment: function () {
+        // здесь можно задать переменные окружения или
+        // изменить / дополнить конфиг Testplane
+    }
+};
+````
+
+</TabItem>
+
+</Tabs>
+
+### Описание разделов конфигурации {#config_sections_description}
+
+Единственным обязательным разделом в настройках Testplane является раздел `browsers`.
+
+Также большинство [настроек браузеров][browsers] можно вынести на глобальный уровень, чтобы они применялись для всех браузеров, а не повторялись в настройках каждого браузера снова и снова.
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[browsers][browsers]</td><td>Обязательный раздел. В нем задаются настройки всех браузеров, в которых будут запускаться тесты.</td></tr>
+<tr><td>[sets][sets]</td><td>Раздел, позволяющий привязать набор тестов к определенным браузерам и запускать их сразу одной командой. Может пригодиться, например, для отдельного запуска десктопных и мобильных тестов.</td></tr>
+<tr><td>[system][system]</td><td>Раздел системных настроек Testplane. Позволяет задать число подпроцессов, в которых будут запускаться тесты, включить режим дебага для WebDriver, и многое другое.</td></tr>
+<tr><td>[plugins][plugins]</td><td>Раздел, с помощью которого можно подключить к testplane внешние плагины.</td></tr>
+<tr><td>[prepareBrowser][prepare-browser]</td><td>Функция, в которой можно подготовить браузер до того, как в нем будут запущены тесты. Например, в этой функции можно добавить новые команды для объекта _browser_.</td></tr>
+<tr><td>[prepareEnvironment][prepare-environment]</td><td>Функция, в которой можно задать переменные окружения или, например, дополнить какие-то параметры конфига.</td></tr>
+
+</tbody>
+</table>
+
+Перейдите по ссылке или выберите нужный раздел в левом навигационном меню документации, чтобы почитать подробнее о соответствующих настройках.
+
+## Использование {#usage}
+
+По умолчанию testplane при запуске ищет файл `.testplane.conf.js` в текущей рабочей папке.
+
+Вы можете задать свой конфигурационный файл с помощью CLI-опции `--config`, указав в качестве значения опции путь к файлу относительно текущей рабочей папки.
+
+[browsers]: ./browsers
+[sets]: ./sets
+[system]: ./system
+[plugins]: ./plugins
+[prepare-browser]: ./prepare-browser
+[prepare-environment]: ./prepare-environment
diff --git a/docs/config/plugins.mdx b/docs/config/plugins.mdx
new file mode 100644
index 0000000..5b1c906
--- /dev/null
+++ b/docs/config/plugins.mdx
@@ -0,0 +1,82 @@
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+import Admonition from "@theme/Admonition";
+
+# plugins
+
+## Обзор {#overview}
+
+С помощью раздела `plugins` вы можете подключить к Testplane внешние плагины, которые расширят доступную функциональность.
+
+Например, плагины [html-reporter][html-reporter] или [testplane-test-repeater][testplane-test-repeater].
+
+Плагин — это модуль, который экспортирует одну функцию со следующими аргументами:
+
+-   инстанс Testplane
+-   опции плагина из конфига Testplane
+
+Все плагины будут загружены до того, как Testplane запустит тесты.
+
+<Admonition type="tip">
+    Выбирая название для плагина, добавьте к нему префикс _testplane-_. Тогда такой плагин будет
+    проще искать.
+</Admonition>
+
+Если имя плагина начинается с префикса `testplane-`, то этот префикс можно опустить при добавлении плагина в раздел `plugins`. Если на файловой системе будут находиться модули с обоими именами: _testplane-some-module_ и _some-module_, то предпочтение будет отдано модулю с префиксом `testplane-`.
+
+## Схематичный пример {#example}
+
+<Tabs>
+<TabItem value=".testplane.conf.js" label=".testplane.conf.js">
+```javascript
+  module.exports = {
+      plugins: {
+          'my-cool-plugin': {
+              param: 'some-value'
+          },
+
+          // другие плагины testplane...
+      },
+
+      // другие настройки testplane...
+
+};
+
+````
+</TabItem>
+
+
+<TabItem value="testplane-my-cool-plugin/index.js" label="testplane-my-cool-plugin/index.js">
+```javascript
+module.exports = function(testplane, opts) {
+    testplane.on(testplane.events.RUNNER_START, function(runner) {
+        console.info(opts.param); // выведет значение some-value, см. конфиг плагина в testplane
+
+        return setUp(testplane.config, opts.param); // параметры конфига можно менять
+    });
+
+    testplane.on(testplane.events.RUNNER_END, function() {
+        return tearDown();
+    });
+};
+````
+
+</TabItem>
+
+</Tabs>
+
+## Свойства инстанса testplane {#testplane_instance}
+
+<table>
+<thead>
+<tr><td>config</td><td>Конфиг, который используется в test runner'е. Может быть изменен.</td></tr>
+</thead>
+<tbody>
+<tr><td>events</td><td>Список событий, на которые можно подписаться.</td></tr>
+
+</tbody>
+</table>
+
+[html-reporter]: ../html-reporter/html-reporter-setup
+[testplane-test-repeater]: ../plugins/testplane-test-repeater
diff --git a/docs/config/prepare-browser.mdx b/docs/config/prepare-browser.mdx
new file mode 100644
index 0000000..3dff5fc
--- /dev/null
+++ b/docs/config/prepare-browser.mdx
@@ -0,0 +1,159 @@
+import Admonition from "@theme/Admonition";
+
+# prepareBrowser
+
+## Обзор {#overview}
+
+Данный параметр является хуком. Функция, заданная для данного параметра, будет автоматически вызвана перед тем, как запустить в браузере тесты. В качестве аргумента функция получает ссылку на сессию браузера.
+
+Обычно внутри данной функции к браузеру добавляют новые команды, или расширяют поведение уже существующих команд.
+
+## Примеры использования {#example}
+
+### Пример 1: добавляем новую команду для браузера {#example_add_new_command_to_browser}
+
+Для добавления новой команды воспользуемся функцией [browser.addCommand()][add-command] WebDriverIO.
+
+```javascript
+const querystring = require("querystring");
+
+function toStoryKind(value) {
+    /* here goes some code */
+}
+function toStoryId(value) {
+    /* here goes some code */
+}
+
+module.exports = {
+    prepareBrowser: function (browser) {
+        browser.addCommand("openScenario", function openScenario(rawComponent, rawStory, params) {
+            const component = toStoryKind(rawComponent);
+            const story = toStoryId(rawStory);
+            const queryParams = querystring.stringify(params);
+            const url = `/storybook/iframe.html?id=components-${component}-testplane--${story}&${queryParams}`;
+
+            return this.url(url);
+        });
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+### Пример 2: добавляем новую команду для элемента {#example_2_add_new_command_to_element}
+
+Можно добавить команду не для браузера, а для элемента. Тогда третьим аргументом функции [browser.addCommand()][add-command] надо указать `true`.
+
+<Admonition type="warning">
+    Если добавляется команда для элемента, а не для браузера, то функция выполняется в контексте
+    элемента!
+</Admonition>
+
+```javascript
+module.exports = {
+    prepareBrowser: function(browser) {
+        await browser.addCommand(
+            'getCoords',
+            async function () {
+                // внутри функции контекстом является element, не browser!
+                const { x, y } = await this.getLocation();
+                const { width, height } = await this.getSize();
+
+                return {
+                    left: x,
+                    top: y,
+                    right: x + width,
+                    bottom: y + height
+                };
+            },
+            true // true означает, что мы задаем функцию для элемента, (по умолчанию) false – для браузера
+        );
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+Внутри функции применяются команды [getLocation()][get-location] и [getSize()][get-size], которые доступны для элемента в WebDriverIO.
+
+После добавления команды `getCoords()`, её можно использовать в тестах следующим образом:
+
+```javascript
+const { left, top, right, bottom } = await browser.$(‘.selector’).getCoords();
+```
+
+### Пример 3: меняем уже существующую команду {#example_3_overwrite_command}
+
+Чтобы изменить уже существующую команду, воспользуемся командой [browser.overwriteCommand()][overwrite-command] WebDriverIO.
+
+Например, мы можем захотеть передавать в команду [browser.url()][url] отдельным аргументом объект с query-параметрами:
+
+```javascript
+const { URL } = require("url");
+
+module.exports = {
+    prepareBrowser: function (browser) {
+        browser.overwriteCommand("url", function (origUrlFunction, uri, query) {
+            if (!query) {
+                return origUrlFunction(uri);
+            }
+
+            const parsedUrl = new URL(uri);
+
+            for (const [key, value] of Object.entries(query)) {
+                parsedUrl.searchParams.set(key, value);
+            }
+
+            return origUrlFunction(parsedUrl.href);
+        });
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+### Пример 4: добавляем набор команд из папки {#example_4_add_commands_from_folder}
+
+Если в проекте много своих специфических команд, то их удобно хранить в отдельной папке, а в `prepareBrowser` добавлять все команды сразу унифицированным образом. Например:
+
+```javascript
+const path = require("path");
+const glob = require("fast-glob");
+
+module.exports = {
+    prepareBrowser: function (browser) {
+        const files = glob.sync(["tests/testplane/commands/*.(js|ts)", "!**/*.d.ts"]);
+
+        files.forEach(file => {
+            const module = require(path.resolve(process.cwd(), file));
+            const name = path.basename(file, path.extname(file));
+
+            browser.addCommand(name, typeof module === "object" ? module[name] : module);
+        });
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+При этом файл с одной из команд может выглядеть так:
+
+```javascript
+// tests/testplane/commands/yaCheckCookie.js
+
+module.exports = async function (cookieName) {
+    // контекстом в функции является browser
+    const cookies = await this.getCookies(cookieName);
+
+    assert.isTrue(cookies[0], `cookie с именем ${cookieName} не установлено`);
+};
+```
+
+Здесь используется команда [browser.getCookies()][get-cookies] WebDriverIO.
+
+[url]: ../commands/browser/url
+[add-command]: ../commands/browser/addCommand
+[overwrite-command]: ../commands/browser/overwriteCommand
+[get-cookies]: ../commands/browser/getCookies
+[get-location]: ../commands/element/getLocation
+[get-size]: ../commands/element/getSize
diff --git a/docs/config/prepare-environment.mdx b/docs/config/prepare-environment.mdx
new file mode 100644
index 0000000..789263c
--- /dev/null
+++ b/docs/config/prepare-environment.mdx
@@ -0,0 +1,21 @@
+# prepareEnvironment
+
+## Обзор {#overview}
+
+Данный параметр является хуком. Функция, заданная для данного параметра, будет автоматически вызвана после чтения конфига Testplane. С помощью нее можно задать переменные окружения или, например, дополнить какие-то параметры конфига.
+
+Контекстом функции является конфиг Testplane.
+
+## Пример использования {#example}
+
+```javascript
+const { pick } = require("lodash");
+
+module.exports = {
+    prepareEnvironment: function () {
+        this.sets = pick(this.sets, ["touch-phone"]);
+    },
+
+    // другие настройки Testplane...
+};
+```
diff --git a/docs/config/sets.mdx b/docs/config/sets.mdx
new file mode 100644
index 0000000..dc53a09
--- /dev/null
+++ b/docs/config/sets.mdx
@@ -0,0 +1,110 @@
+# sets
+
+## Обзор {#overview}
+
+Вы можете использовать сеты _(sets)_, чтобы привязать набор тестов к определенным браузерам и запускать их сразу одной командой.
+
+Например, это может быть удобно для запуска тестов по платформам: `desktop`, `touch-phone` и т. п. Также у вас может быть `common` сет, соответствующий общим тестам, которые вы будете запускать всегда во всех браузерах.
+
+Набор тестов задается как массив путей к ним или к папкам с ними на файловой системе. Также вы можете задать пути, которые нужно игнорировать при поиске тестов, чтобы ускорить процесс чтения тестов Testplane.
+
+Если сетов в конфиге не будет, или вы не укажете их при запуске Testplane (см. раздел «[Использование](#usage)»), то будут запущены все тесты из папки `testplane` во всех браузерах, которые были указаны в разделе [browsers][browsers] конфига Testplane.
+
+## Настройка {#setup}
+
+Раздел `sets` имеет следующий формат:
+
+```javascript
+module.exports = {
+    sets: {
+        <set-id>: {
+            files: [
+                'path-1',
+                'some/folder/**/*.some-ext',
+                // остальные пути к файлам с тестами...
+            ],
+            ignoreFiles: [
+                'ignorePath-1',
+                'some/ignore/folder/**/',
+                // остальные пути, которые нужно игнорировать при поиске и чтении тестов...
+            ],
+            browsers: [
+                'browser-1',
+                'browser-2',
+                // остальные браузеры, в которых нужно запускать тесты по указанным в files путям...
+            ]
+        },
+
+        // настройки других сетов...
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+Где `<set-id>` — это имя сета, которое используется для его идентификации.
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>files</td><td>Array или String</td><td>_N/A_</td><td>Список путей к файлам или папкам с тестами. В случае одного пути параметр можно задавать как строку. Также можно использовать [маски][fast-glob-patterns].</td></tr>
+<tr><td>ignoreFiles</td><td>Array или String</td><td>`[ ]`</td><td>Список путей или [масок][fast-glob-patterns], которые нужно игнорировать при поиске файлов с тестами. Данный параметр позволяет ускорить чтение тестов Testplane.</td></tr>
+<tr><td>browsers</td><td>Array</td><td>_все браузеры_</td><td>Список браузеров, в которых будут запускаться тесты. Можно указывать только браузеры, которые есть в разделе [browsers][browsers] конфига Testplane. По умолчанию все браузеры из раздела [browsers][browsers].</td></tr>
+
+</tbody>
+</table>
+
+## Пример настройки {#setup_example}
+
+```javascript
+module.exports = {
+    sets: {
+        common: {
+            // запускать тесты из папки tests/common во всех браузерах,
+            // которые сконфигурированы в разделе browsers
+            files: "tests/common/*.testplane.js",
+        },
+
+        desktop: {
+            files: ["tests/desktop/*.testplane.js", "tests/common/*.testplane.js"],
+            // исключить папки со скриншотами во время поиска файлов с тестами
+            ignoreFiles: ["**/screens/**"],
+            // запускать тесты в десктопных браузерах
+            browsers: ["chrome", "firefox"],
+        },
+    },
+
+    browsers: {
+        chrome: {
+            // настройки браузера chrome...
+        },
+        firefox: {
+            // настройки браузера firefox...
+        },
+        iphone: {
+            // настройки браузера iphone...
+        },
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+## Использование {#usage}
+
+Используйте CLI-опцию `--set`, чтобы указать сет при запуске тестов.
+
+Пример как запустить тесты для desktop-платформы в случае конфигурации, приведенной [выше](#setup_example):
+
+```bash
+testplane --set desktop
+```
+
+Если в конфиге нет сетов, или они есть, но опция `--set` не была указана, и testplane не были переданы пути через CLI, то будут запущены все тесты из папки `testplane` во всех [браузерах][browsers].
+
+[fast-glob-patterns]: https://github.com/mrmlnc/fast-glob#pattern-syntax
+[browsers]: ./browsers
diff --git a/docs/config/system.mdx b/docs/config/system.mdx
new file mode 100644
index 0000000..cb4f33b
--- /dev/null
+++ b/docs/config/system.mdx
@@ -0,0 +1,165 @@
+import Admonition from "@theme/Admonition";
+
+# system
+
+## Обзор {#overview}
+
+Раздел `system` в настройках Testplane не является обязательным.
+
+Используйте его, чтобы:
+
+-   включить режим дебага для WebDriver'а;
+-   изменить mocha-таймауты для тестов;
+-   занести какие-либо данные в глобальный контекст, который будут видеть все тесты;
+-   задать типы ошибок, при которых нужно закрывать текущую сессию браузера навсегда, а не пытаться её переиспользовать;
+-   задать число подпроцессов, в которых будут запускаться тесты, чтобы ускорить их выполнение;
+-   определить максимально доступное количество браузеров в один момент времени (может быть актуально, если вы получаете браузеры из облачного сервиса, где есть такие ограничения);
+-   задать расширения файлов, среди которых Testplane будет искать тесты;
+-   и т. д.
+
+## Настройка {#setup}
+
+Раздел `system` имеет следующий формат:
+
+```javascript
+module.exports = {
+    system: {
+        debug: false,
+        mochaOpts: {
+            timeout: 60000,
+        },
+        ctx: {
+            // ...
+        },
+        // Сессия будет закрыта, если тест упадет с ошибкой,
+        // соответствующей одному из указанных шаблонов,
+        // после чего будет создана новая сессия,
+        // чтобы исключить инфраструктурные проблемы
+        patternsOnReject: [
+            /timeout/i,
+            /timedout/i,
+            /timed out/i,
+            // ...
+        ],
+        workers: 1,
+        testsPerWorker: Infinity,
+        parallelLimit: 15,
+        fileExtensions: [".js", ".ts"],
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[debug](#debug)</td><td>Boolean</td><td>false</td><td>Включить / отключить режим отладки для WebDriver.</td></tr>
+<tr><td>[mochaOpts](#mocha_opts)</td><td>Object</td><td>_[см. ниже](#mocha_opts)_</td><td>Дополнительные опции для _mocha_.</td></tr>
+<tr><td>[ctx](#ctx)</td><td>Object</td><td>`{ }`</td><td>Контекст, который будет доступен во всех тестах через метод _testplane.ctx._</td></tr>
+<tr><td>[patternsOnReject](#patterns_on_reject)</td><td>Array</td><td>`[ ]`</td><td>Список шаблонов ошибок. Сессия будет закрыта, если тест упадет с ошибкой, соответствующей одному из указанных шаблонов. После чего будет создана новая сессия, чтобы исключить инфраструктурные проблемы.</td></tr>
+<tr><td>[workers](#workers)</td><td>Number</td><td>1</td><td>Число подпроцессов, которые будут запущены для выполнения тестов.</td></tr>
+<tr><td>[testsPerWorker](#tests_per_worker)</td><td>Number</td><td>Infinity</td><td>Максимальное количество тестов, которые будут запущены в одном подпроцессе, прежде чем подпроцесс будет перезапущен.</td></tr>
+<tr><td>[parallelLimit](#parallel_limit)</td><td>Number</td><td>1</td><td>Максимальное количество браузеров, которые могут быть запущены одновременно.</td></tr>
+<tr><td>[fileExtensions](#file_extensions)</td><td>Array</td><td>`[.js]`</td><td>Расширения файлов, в которых Testplane будет искать тесты для запуска.</td></tr>
+
+</tbody>
+</table>
+
+### debug {#debug}
+
+Включает режим отладки для WebDriver, если установить значение в `true`. По умолчанию: `false`.
+
+### mochaOpts {#mocha_opts}
+
+Дополнительные опции для `mocha`, которые передаются в `mocha.setup`. См. список доступных опций в [документации для Mocha](https://mochajs.org/). По умолчанию: `{ timeout: 60000 }`.
+
+```javascript
+module.exports = {
+    system: {
+        mochaOpts: {
+            timeout: 60000, // таймаут выполнения теста
+        },
+
+        // другие системные настройки...
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+### ctx {#setup_ctx}
+
+Контекст, который будет доступен во всех тестах через метод `testplane.ctx`. Предназначен для совместного использования каких-либо данных между всеми тестами, без необходимости прибегать к использованию глобальных переменных.
+
+Например:
+
+```javascript
+module.exports = {
+    system: {
+        ctx: {
+            services: ["video", "images"],
+        },
+
+        // другие системные настройки...
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+```javascript
+it("awesome test", function () {
+    console.log(testplane.ctx); // { services: ['video', 'images'] }
+});
+```
+
+<Admonition type="tip">
+    Используйте в тестах _testplane.ctx_ вместо глобальных переменных.
+</Admonition>
+
+### patternsOnReject {#patterns_on_reject}
+
+Сессия будет закрыта, если тест упадет с ошибкой, соответствующей одному из указанных шаблонов в `patternsOnReject`. После чего будет создана новая сессия, чтобы исключить инфраструктурные проблемы.
+
+Пример:
+
+```javascript
+module.exports = {
+    system: {
+        patternsOnReject: [
+            /timeout/i,
+            /timedout/i,
+            /timed out/i,
+
+            // другие шаблоны...
+        ],
+
+        // другие системные настройки...
+    },
+
+    // другие настройки Testplane...
+};
+```
+
+### workers {#workers}
+
+Testplane запускает все тесты в подпроцессах, чтобы уменьшить использование CPU для главного процесса и не упираться в ограничение по памяти для _Node.js._ Данная опция задает число подпроцессов, которые будут запущены для выполнения тестов. По умолчанию: `1`.
+
+### testsPerWorker {#tests_per_worker}
+
+Максимальное количество тестов, которые будут запущены в одном подпроцессе, прежде чем подпроцесс будет перезапущен. По умолчанию: `Infinity`.
+
+### parallelLimit {#parallel_limit}
+
+По умолчанию Testplane запускает все браузеры одновременно. Иногда (например, при использовании облачных сервисов, таких как [SauceLabs][sauce-labs]) вам может понадобиться ограничить количество браузеров, которые могут быть запущены одновременно. Данная опция задает это ограничение. По умолчанию: `Infinity`.
+
+### fileExtensions {#file_extensions}
+
+Расширения файлов, в которых Testplane будет искать на файловой системе тесты для запуска. По умолчанию: `[.js]`.
+
+[sauce-labs]: https://saucelabs.com
diff --git a/docs/guides/how-to-add-testing-library.mdx b/docs/guides/how-to-add-testing-library.mdx
new file mode 100644
index 0000000..2943e84
--- /dev/null
+++ b/docs/guides/how-to-add-testing-library.mdx
@@ -0,0 +1,65 @@
+# Как подключить testing-library в testplane
+
+## Введение {#preface}
+
+[Testing-library][testing-library] - это коллекция инструментов для тестирования пользовательского интерфейса веб-приложений, ориентированная на создание надежных и поддерживаемых тестов, сосредотачиваясь на пользовательском поведении. Основное преимущество `testing-library` заключается в фокусе на взаимодействии с элементами интерфейса. И в testplane можно пользоваться способами поиска элемента, представленными самой библиотекой `testing-library`.
+
+## Подключение
+
+Для того, чтобы появилась возможность использования [запросов (queries)][queries] из `testing-library` в testplane-тестах, необходимо выполнить всего несколько шагов.
+
+1. Установите npm-пакет `'@testing-library/webdriverio'`
+
+```bash
+npm i -D @testing-library/webdriverio
+```
+
+2. Подключите реализацию в конфиге testplane в секции `prepareBrowser`
+
+```javascript
+// .testplane.conf.js
+const { setupBrowser } = require("@testing-library/webdriverio");
+
+module.exports = {
+    prepareBrowser(browser) {
+        setupBrowser(browser);
+    },
+
+    // другие настройки testplane...
+};
+```
+
+## Использование
+
+После подключения вы сможете использовать в тестах поиск по селекторам из `testing-library`, описанные в [официальной документации](https://testing-library.com/docs/queries/about/). Например, поиск элемента по его тексту
+
+```javascript
+it("example", async ({ browser }) => {
+    await browser.url("https://github.com/");
+
+    const newRepoButton = await browser.getByText("New");
+
+    await newRepoButton.click();
+});
+```
+
+В контексте найденных элементов эта возможность также будет доступна:
+
+```javascript
+it("example", async ({ browser }) => {
+    await browser.url("https://github.com/");
+
+    const sidebar = await browser.$(".dashboard-sidebar");
+    const newRepoButton = await sidebar.getByText("New");
+
+    await newRepoButton.click();
+});
+```
+
+## Полезные ссылки {#useful_links}
+
+-   [Testing-library][testing-library]
+-   [WebdriverIO Testing Library](https://testing-library.com/docs/webdriverio-testing-library/intro)
+
+[testing-library]: https://testing-library.com/
+[queries]: https://testing-library.com/docs/queries/about
diff --git a/docs/guides/how-to-check-accessibility.mdx b/docs/guides/how-to-check-accessibility.mdx
new file mode 100644
index 0000000..8b546cf
--- /dev/null
+++ b/docs/guides/how-to-check-accessibility.mdx
@@ -0,0 +1,84 @@
+import Admonition from "@theme/Admonition";
+
+# Как протестировать доступность (accessibility) страницы
+
+## Обзор {#overview}
+
+<Admonition type="warning">
+Данный рецепт работает только при использовании _Chrome DevTools Protocol (CDP)_.
+
+Читайте подробности в разделе «[Как использовать CDP в Testplane][how-to-use-cdp]»
+
+</Admonition>
+
+[Accessibility tree][accessibility-tree] — это дерево доступности, которое содержит иерархическую структуру доступных объектов. В отличие от DOM-дерева, которое предназначено для браузеров, accessibility-дерево предназначено для [скрин-ридеров][screen-reader] и других инструментов, помогающих взаимодействовать с сайтами людям с ограниченными возможностями.
+
+Для получения такого дерева в _puppeteer_ есть специальный [класс Accessibility][puppeteer-accessibility].
+
+## Пример {#example}
+
+Вот пример, как его можно использовать:
+
+```javascript
+it("should get accessibility tree of yandex.ru", async function () {
+    // Получаем инстанс puppeteer'а
+    const puppeteer = await this.browser.getPuppeteer();
+
+    // Получаем первую открытую страницу (считаем, что она активная в данный момент)
+    const [page] = await puppeteer.pages();
+
+    await this.browser.url("https://yandex.ru");
+
+    // Получаем текущее состояние accessibility дерева
+    const snapshot = await page.accessibility.snapshot();
+    console.log("snapshot:", JSON.stringify(snapshot, null, 4));
+});
+```
+
+## Accessibility-дерево {#accessibility_tree}
+
+А вот как выглядит получаемое accessibility-дерево:
+
+```json
+{
+    "role": "WebArea",
+    "name": "Яндекс",
+    "children": [
+        {
+            "role": "link",
+            "name": "Войти"
+        },
+        {
+            "role": "link",
+            "name": "Почта"
+        },
+        {
+            "role": "link",
+            "name": "Диск"
+        },
+        {
+            "role": "link",
+            "name": "Попробовать Плюс"
+        },
+
+        // пропустим для краткости...
+
+        {
+            "role": "link",
+            "name": "финансы"
+        },
+        {
+            "role": "link",
+            "name": "политика"
+        }
+    ]
+}
+}
+```
+
+Используя полученное дерево мы можем проверить, что все необходимые узлы содержатся в дереве и имеют правильную структуру.
+
+[how-to-use-cdp]: ./how-to-use-cdp
+[accessibility-tree]: https://web.dev/the-accessibility-tree/
+[screen-reader]: https://ru.wikipedia.org/wiki/Экранное_считывающее_устройство
+[puppeteer-accessibility]: https://pptr.dev/api/puppeteer.accessibility
diff --git a/docs/guides/how-to-check-test-stability.mdx b/docs/guides/how-to-check-test-stability.mdx
new file mode 100644
index 0000000..0bfca91
--- /dev/null
+++ b/docs/guides/how-to-check-test-stability.mdx
@@ -0,0 +1,51 @@
+# Как проверить стабильность теста
+
+## Проблема {#problem}
+
+Существует масса причин, из-за которых тесты могут падать:
+
+-   проблемы с инфраструктурой — недоступность браузеров, некорректная работа сети, протухание доступов и т. п.
+-   проблемы с внешними сервисами, к которым обращается тест —
+-   гонки в самом тесте, когда какой-либо элемент не успел прорисоваться, а контрольное время его ожидания истекло;
+-   внезапно возникающие попапы при выполнении теста, которые перекрывают нужный элемент, вносят дифф в отснятый скриншот, не дают кликнуть по нужному элементу;
+-   и т. д. и т. п.
+
+Часто такие падения не воспроизводятся с первого раза. Поэтому, чтобы убедиться, что свеженаписанный тест стабилен, нужно запустить его много раз. Но есть одна проблема: если вы запустите свой тест в testplane _as is,_ то после первого же успешного прогона testplane прекратит запускать ваш тест. Тест прошел — всё ОК. Но для проверки стабильности этого недостаточно. Может быть, тест прошел случайно, и если запустить его повторно, то он упадет. Хотелось бы запустить его не 1 раз, и не 2, а например, 20 раз и посмотреть сколько раз он успешно пройдет при 20 повторах. Или 30. Или... и т. д.
+
+## Решение: testplane-test-repeater {#solution}
+
+Для решения данной проблемы был разработан плагин [testplane-test-repeater][testplane-test-repeater].
+
+Плагин позволяет запустить один и тот же тест (или группу тестов) требуемое количество раз.
+
+Плагин гарантирует, что тесты будут запущены столько раз, сколько вы задали, независимо от результатов их прогона в каждой попытке. Кроме того, плагин позволяет запускать тесты каждый раз в новой сессии браузера. Это исключает влияние деградации браузера или еще какие-либо побочные эффекты, которые могли бы возникнуть при повторных прогонах в одной и той же сессии браузера.
+
+Подробнее о том, как добавить этот плагин в проект, настроить и использовать его, читайте в [документации плагина][testplane-test-repeater].
+
+## Примеры использования {#usage}
+
+Ниже приведены примеры прогонов тестов, в которых их прогнали 21 раз (1 основной + 20 ретраев), чтобы проверить их на стабильность.
+
+### Пример сломанных тестов
+
+Как видно из скриншота тесты были запущены 21 раз и ни разу не завершились успешно:
+
+![Неработающий тест](/img/docs/guides/how-to-check-test-stability.total-failure.png)
+
+### Пример стабильного теста
+
+А здесь наоборот — все запуски прошли успешно:
+
+![Стабильный тест](/img/docs/guides/how-to-check-test-stability.total-success.png)
+
+### Пример нестабильных тестов
+
+На следующем скриншоте первый тест практически не рабочий — из 21 попытки только 1 раз тест прошел. А второй тест — достаточно стабильный, хотя 2 падения из 21 — это все равно не 100%-ная стабильность. И разработчик может попытаться разобраться, почему все-таки тест иногда падает.
+
+![Нестабильный тест](/img/docs/guides/how-to-check-test-stability.unstable-test.png)
+
+## Ключевые слова {#keywords}
+
+-   testplane-test-repeater
+
+[testplane-test-repeater]: ../plugins/testplane-test-repeater
diff --git a/docs/guides/how-to-debug-test.mdx b/docs/guides/how-to-debug-test.mdx
new file mode 100644
index 0000000..346dbdb
--- /dev/null
+++ b/docs/guides/how-to-debug-test.mdx
@@ -0,0 +1,62 @@
+import Admonition from "@theme/Admonition";
+
+# Как отладить работу теста
+
+## Проблема {#problem}
+
+При разработке тестов, рано или поздно, любой разработчик начинает сталкиваться с ошибками, которые трудно обнаружить с помощью обычного просмотра кода. И тогда приходится применять уже программные инструменты, чтобы понять, где закралась ошибка, или почему тест ведет себя не так, как от него ожидает разработчик.
+
+Давайте разберемся, какие возможности есть у разработчика testplane-тестов.
+
+## Решение 1: опция --inspect или --inspect-brk {#solution_1}
+
+Для того чтобы видеть как тест выполняется шаг за шагом, в testplane существует режим отладки. Этот режим опирается на [интеграцию V8 инспектора с Node.js](https://nodejs.org/dist/latest-v16.x/docs/api/debugger.html#advanced-usage).
+
+<details>
+
+<summary>
+Про интеграцию V8 инспектора с Node.js
+
+</summary>
+
+Интеграция с инспектором _V8_ позволяет подключать _Chrome DevTools_ к инстансу _Node.js_ для отладки и профилирования. Для этого используется протокол _Chrome DevTools._
+
+Инспектор _V8_ можно включить, передав опцию `--inspect` при запуске приложения на _Node.js._ Также можно указать пользовательский порт с этой опцией, например, `--inspect=9222` будет принимать подключения `DevTools` на порту `9222`.
+
+Чтобы остановить выполнение кода на первой строке приложения, вместо опции `--inspect` используйте опцию `--inspect-brk`.
+
+```bash
+$ node --inspect index.js
+Debugger listening on ws://127.0.0.1:9229/dc9010dd-f8b8-4ac5-a510-c1a114ec7d29
+For help, see: https://nodejs.org/en/docs/inspector
+```
+
+_В приведенном выше примере `UUID dc9010dd-f8b8-4ac5-a510-c1a114ec7d29` в конце URL'а генерируется «на лету», и отличается в разных сеансах отладки._
+
+Если браузер Chrome старше `66.0.3345.0`, используйте `inspector.html` вместо `js_app.html` в приведенном выше URL-адресе.
+
+_Chrome DevTools_ пока не поддерживает отладку [рабочих потоков](https://nodejs.org/dist/latest-v16.x/docs/api/worker_threads.html). Для их отладки можно использовать [ndb](https://github.com/GoogleChromeLabs/ndb/).
+
+</details>
+
+Чтобы запустить тест в этом режиме, используйте опцию `--inspect`. Если вы хотите, чтобы отладчик остановился на первой строке кода, то используйте опцию `--inspect-brk`.
+
+Пример:
+
+```bash
+testplane path/to/mytest.js --inspect
+```
+
+<Admonition type="info">
+    В режиме отладки запускается только один рабочий процесс, и все тесты выполняются только в нем.
+    Используйте этот режим с параметром _sessionsPerBrowser=1_ для отладки тестов по одному за раз.
+</Admonition>
+
+## Ключевые слова {#keywords}
+
+-   --inspect
+-   --inspect-brk
+
+## Полезные ссылки {#useful_links}
+
+-   [Про Chrome DevTools](https://developer.chrome.com/docs/devtools/)
diff --git a/docs/guides/how-to-get-report.mdx b/docs/guides/how-to-get-report.mdx
new file mode 100644
index 0000000..1186f26
--- /dev/null
+++ b/docs/guides/how-to-get-report.mdx
@@ -0,0 +1,98 @@
+# Как получить отчет о прогоне тестов
+
+## Отчет testplane {#testplane_report}
+
+После завершения прогона всех тестов testplane пишет в консоль результат прогона в виде строки следующего вида:
+
+```bash
+Total: 1812 Passed: 1792 Failed: 0 Skipped: 20 Retries: 47
+```
+
+Где:
+
+<table>
+<thead>
+<tr><td>Статус</td><td>Описание</td></tr>
+</thead>
+<tbody>
+<tr><td>Total</td><td>Общее количество тестов, которые testplane прочитала с файловой системы при запуске.</td></tr>
+<tr><td>Passed</td><td>Число тестов, которые успешно прошли.</td></tr>
+<tr><td>Failed</td><td>Число тестов, которые упали.</td></tr>
+<tr><td>Skipped</td><td>Количество тестов, которые были пропущены (заскипаны) при запуске.</td></tr>
+<tr><td>Retries</td><td>Суммарное количество ретраев тестов, которые произошли во время прогона.</td></tr>
+
+</tbody>
+</table>
+
+Однако этой информации может быть недостаточно, поэтому вы можете добавить в свой проект плагин [stat-reporter][stat-reporter].
+
+## Отчет плагина stat-reporter {#stat_reporter_report}
+
+Если вы добавите в свой проект плагин [stat-reporter][stat-reporter], то тогда после завершения прогона всех тестов вы получите в консоли более подробный отчет о результатах прогона. Например:
+
+```bash
+┌──────────────────────┬────────┬───────┬────────┬────────┬─────────┬─────────┬──────────┐
+│ Browser              │ Status │ Tests │ Passed │ Failed │ Skipped │ Retries │ Duration │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ firefox              │ passed │ 25    │ 24     │ 0      │ 1       │ 0       │ 01:02    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-desktop       │ passed │ 466   │ 464    │ 0      │ 2       │ 4       │ 07:40    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ ipad                 │ passed │ 24    │ 23     │ 0      │ 1       │ 0       │ 01:27    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ iphone               │ passed │ 376   │ 372    │ 0      │ 4       │ 7       │ 07:12    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-phone         │ passed │ 427   │ 421    │ 0      │ 6       │ 14      │ 07:32    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ iphone-dark          │ passed │ 74    │ 72     │ 0      │ 2       │ 4       │ 02:18    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ searchapp-phone      │ passed │ 319   │ 317    │ 0      │ 2       │ 9       │ 10:00    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ safari13             │ passed │ 15    │ 13     │ 0      │ 2       │ 4       │ 02:42    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-desktop-1920  │ passed │ 3     │ 3      │ 0      │ 0       │ 0       │ 00:57    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ iphoneX              │ passed │ 3     │ 3      │ 0      │ 0       │ 0       │ 00:36    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-desktop-dark  │ passed │ 77    │ 77     │ 0      │ 0       │ 5       │ 01:33    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ yandex-browser-phone │ passed │ 1     │ 1      │ 0      │ 0       │ 0       │ 00:28    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-grid-720      │ passed │ 2     │ 2      │ 0      │ 0       │ 0       │ 00:49    │
+└──────────────────────┴────────┴───────┴────────┴────────┴─────────┴─────────┴──────────┘
+```
+
+В отличие от простого отчета testplane, в отчете плагина `stat-reporter` результаты прогонов разбиты по браузерам. Также выводятся максимальное время выполнения _(Duration)_ в минутах и секундах и результат прогона тестов _(Status)_ в каждом браузере.
+
+Такой отчет позволяет лучше понять в каких браузерах возникли проблемы, а именно: не проходит больше всего тестов или время выполнения резко возросло.
+
+Плагин `stat-reporter` также позволяет формировать отчеты в виде html- или json-файлов. См. подробности в [описании плагина][stat-reporter].
+
+Однако по своим возможностям плагин [stat-reporter][stat-reporter] значительно уступает плагину [html-reporter][html-reporter], который предоставляет разработчику гораздо более продвинутые способы работы с тестами и результатами их прогона.
+
+## Отчет плагина html-reporter {#html_reporter_report}
+
+Добавьте в свой проект плагин [html-reporter][html-reporter], чтобы получить графический html-отчет с результатами прогонов всех тестов. Также в полученном отчете вы сможете:
+
+-   отфильтровать тесты по статусам завершения;
+-   сгруппировать тесты по ошибкам или любому параметру из мета-информации теста;
+-   посмотреть диффы в скриншотах 6 разными способами;
+-   посмотреть отдельно все ретраи или ошибки в тестах.
+
+![html-reporter](/img/docs/guides/how-to-get-report.html-reporter.png)
+
+Кроме того, [html-reporter][html-reporter] позволяет запускать testplane в специальном GUI-режиме. В этом режиме вы можете запускать и перезапускать тесты, переснимать скриншоты, использовать специальные режимы отладки и многое другое.
+
+## Ключевые слова {#keywords}
+
+-   stat-reporter
+-   html-reporter
+-   gui
+
+## Полезные ссылки {#useful_links}
+
+-   [Плагин stat-reporter][stat-reporter]
+-   [Плагин html-reporter][html-reporter]
+
+[stat-reporter]: ../plugins/stat-reporter
+[html-reporter]: ../html-reporter/html-reporter-setup
diff --git a/docs/guides/how-to-get-rid-of-diffs-in-screenshots.mdx b/docs/guides/how-to-get-rid-of-diffs-in-screenshots.mdx
new file mode 100644
index 0000000..2b0f076
--- /dev/null
+++ b/docs/guides/how-to-get-rid-of-diffs-in-screenshots.mdx
@@ -0,0 +1,6 @@
+# Как победить диффы в скриншотах
+
+## Ключевые слова {#keywords}
+
+-   hermione-reassert-view
+-   ignore в assertView
diff --git a/docs/guides/how-to-hide-scrollbars-by-cdp.mdx b/docs/guides/how-to-hide-scrollbars-by-cdp.mdx
new file mode 100644
index 0000000..6128a6e
--- /dev/null
+++ b/docs/guides/how-to-hide-scrollbars-by-cdp.mdx
@@ -0,0 +1,48 @@
+import Admonition from "@theme/Admonition";
+
+# Как скрывать скроллбары с помощью Chrome DevTools Protocol
+
+## Обзор {#overview}
+
+<Admonition type="warning">
+Данный рецепт работает только при использовании _Chrome DevTools Protocol (CDP)_.
+
+Читайте подробности в разделе «[Как использовать CDP в Testplane][how-to-use-cdp]»
+
+</Admonition>
+
+Одна из причин падений тестов при тестировании верстки с помощью скриншотов — это появление скроллбара в браузере в момент снятия скриншота. Подробнее об этой проблеме и некоторых способах её решения, вы можете прочитать [здесь](./how-to-hide-scrollbars). Особенно часто эта проблема возникает в тестах с мобильной эмуляцией.
+
+В CDP есть специальный метод [Emulation.setScrollbarsHidden][set-scrollbars-hidden], который позволяет скрыть скроллбар. Однако в _puppeteer_ отсутствует обертка над этим методом. Поэтому мы воспользуемся методом [CDPSession.send][cdp-session-send], чтобы выполнить команду [Emulation.setScrollbarsHidden][set-scrollbars-hidden].
+
+## Пример: как отключить скроллбар с помощью CDP {#example}
+
+Вот как это будет выглядеть:
+
+```javascript
+it("should hide scrollbar", async function () {
+    // Получаем инстанс puppeteer'а
+    const puppeteer = await this.browser.getPuppeteer();
+
+    // Получаем первую открытую страницу (считаем, что она активная в данный момент)
+    const [page] = await puppeteer.pages();
+
+    // Создаем CDP-сессию
+    const client = await page.target().createCDPSession();
+
+    // Скрываем скроллбар
+    await client.send("Emulation.setScrollbarsHidden", { hidden: true });
+
+    await this.browser.url("https://yandex.ru");
+});
+```
+
+## Полезные ссылки {#useful_links}
+
+Читайте также наш рецепт «[Как убрать скроллбары из скриншотов](./how-to-hide-scrollbars)».
+
+Там же вы узнаете про плагин [hermione-hide-scrollbars](../plugins/hermione-hide-scrollbars), который реализован на основе метода [Emulation.setScrollbarsHidden][set-scrollbars-hidden] и который вы можете использовать, чтобы отключить скроллбары в CI для всех тестов в конкретных браузерах.
+
+[how-to-use-cdp]: ./how-to-use-cdp
+[set-scrollbars-hidden]: https://chromedevtools.github.io/devtools-protocol/tot/Emulation/#method-setScrollbarsHidden
+[cdp-session-send]: https://pptr.dev/next/api/puppeteer.cdpsession.send
diff --git a/docs/guides/how-to-hide-scrollbars.mdx b/docs/guides/how-to-hide-scrollbars.mdx
new file mode 100644
index 0000000..fccbe5f
--- /dev/null
+++ b/docs/guides/how-to-hide-scrollbars.mdx
@@ -0,0 +1,63 @@
+import Admonition from "@theme/Admonition";
+
+# Как убрать скроллбары из скриншотов
+
+## Проблема {#problem}
+
+Одна из причин падений тестов при тестировании верстки с помощью скриншотов — это появление скроллбара в браузере в момент снятия скриншота. При этом возможны 3 варианта, когда при прогоне теста возникает дифф между эталонным скриншотом и текущим, который был заснят в тесте в момент прогона:
+
+1. В момент снятия эталонного скриншота скроллбара не было, но он появился при снятии текущего скриншота.
+2. В момент снятия эталонного скриншота скроллбар был, однако при снятии текущего скриншота скроллбар появиться не успел.
+3. Скроллбар есть и на эталонном скриншоте и на текущем, но положения скроллбаров, или их размеры, или прозрачность отличаются из-за разницы во времени, когда были сделаны скриншоты относительно появления скроллбара.
+
+На скриншоте ниже приведен пример, который соответствует первому варианту:
+
+![дифф из-за скроллбара](/img/docs/guides/how-to-hide-scrollbars.diff-in-screenshot.png)
+
+## Решение 1: screenshotDelay {#solution_1}
+
+В настройках testplane есть обязательная опция `browsers`, которая задает набор браузеров, доступных в проекте, и их свойства. Выберите браузер, в котором у вас возникают диффы из-за скроллбаров, и добавьте для него опцию `screenshotDelay`:
+
+```javascript
+module.exports = {
+    browsers: {
+        iphone: {
+            screenshotDelay: 600, // Задержка перед снятием скриншота в мс
+
+            // другие настройки браузера...
+        },
+
+        // другие браузеры...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+Опция `screenshotDelay` задает паузу в миллисекундах, которую testplane должна выдержать перед снятием скриншота (прежде чем выполнять команду `assertView`).
+
+### Как это может помочь? {#how_can_it_help}
+
+Часто скриншоты возникают из-за того, что тест должен подскроллить страницу к требуемому элементу, прежде чем сделать скриншот. После того как подскролл выполнен, скроллбар может еще какое-то время «висеть» на экране и соответственно, попасть на скриншот, если тот будет выполнен немедленно. Задержка `screenshotDelay` дает скроллбару время на то, чтобы исчезнуть.
+
+Однако, данный способ помогает далеко не всегда, так как зависит от реализации браузеров и их поведения.
+
+## Решение 2: отключение скроллбаров {#solution_2}
+
+Если скроллбары возникают на скриншотах в Chrome-браузере, то их можно отключить с помощью [DevTools протокола][CDP].
+
+Для этого добавьте в свой проект плагин [hermione-hide-scrollbars][hermione-hide-scrollbars] и укажите в его настройках список браузеров, для которых необходимо отключать скроллбары в тестах.
+
+<Admonition type="warning">
+    Обновите Chrome-браузер до версии 72.1 и выше, чтобы данная функциональность работала в ваших
+    тестах. Так как более ранние версии Chrome-браузеров не поддерживают команду
+    _Emulation.setScrollbarsHidden_, с помощью которой отключаются скроллбары.
+</Admonition>
+
+## Ключевые слова {#keywords}
+
+-   screenshotDelay
+-   hermione-hide-scrollbars
+
+[hermione-hide-scrollbars]: ../plugins/hermione-hide-scrollbars
+[CDP]: https://chromedevtools.github.io/devtools-protocol/
diff --git a/docs/guides/how-to-intercept-requests-and-responses.mdx b/docs/guides/how-to-intercept-requests-and-responses.mdx
new file mode 100644
index 0000000..cae02af
--- /dev/null
+++ b/docs/guides/how-to-intercept-requests-and-responses.mdx
@@ -0,0 +1,346 @@
+import Admonition from "@theme/Admonition";
+
+# Как отслеживать и перехватывать сетевые запросы и ответы
+
+## Обзор {#overview}
+
+[//]: # "TODO: add screencasts"
+
+<Admonition type="warning">
+Данный рецепт работает только при использовании _Chrome DevTools Protocol (CDP)_.
+
+Читайте подробности в разделе «[Как использовать CDP в Testplane][how-to-use-cdp]»
+
+</Admonition>
+
+В CDP имеются домены [Fetch][fetch] и [Network][network], с помощью которых можно получить полный доступ ко всем сетевым запросам и ответам. При использовании Webdriver-протокола нам бы пришлось писать отдельный proxy-сервер и весь трафик направлять через него.
+
+В _webdriverio_ для работы с сетевыми запросами существует метод [mock][mock], который использует API домена [Fetch][fetch].
+
+С помощью этого метода мы можем:
+
+-   замокать запрос к ресурсу и вернуть свои данные;
+-   отменить запрос, вернув необходимую ошибку;
+-   модифицировать ответ от ресурса;
+-   перенаправить с запрошенного ресурса на какой-то другой ресурс;
+-   замокать ресурс и, например, собрать информацию о том, сколько раз этот ресурс вызывался и какой ответ он возвращал.
+
+Давайте попробуем написать тесты с использованием этого API и покрыть разные кейсы. Сразу уточним, что все графические изображения с процессом выполнения тестов замедлены в 2 раза, так как тесты локально выполняются очень быстро и что-то разглядеть довольно проблематично.
+
+## Пример 1: мокаем запрос к google.com и возвращаем свой ответ {#example_1}
+
+```javascript
+it("should mock google.com", async function () {
+    // Мокаем поход на google.com
+    const mock = await this.browser.mock("https://google.com");
+
+    // Возвращаем строку "Hello, world!" вместо ответа от сайта.
+    // Опция "fetchResponse" отвечает за то, нужно ли делать запрос
+    // на замоканный ресурс, по умолчанию - true
+    mock.respond("Hello, world!", { fetchResponse: false });
+
+    await this.browser.url("https://google.com");
+});
+```
+
+По графическому изображению видно, что мы вернули свой текст, при этом в строке браузера отображается как будто мы выполнили переход на _google.com._ Также видно, что мы не замокали фавиконку и она приехала снаружи. Этот же самый пример мы можем написать с использованием API puppeteer'а, для этого в _webdriverio_ реализована команда [getPuppeteer()][get-puppeteer]:
+
+```javascript
+it("should mock google.com using puppeteer api", async function () {
+    // Получаем инстанс puppeteer'а
+    const puppeteer = await this.browser.getPuppeteer();
+
+    // Получаем первую открытую страницу (считаем, что она активная в данный момент)
+    const [page] = await puppeteer.pages();
+
+    // Активируем перехват всех запросов
+    await page.setRequestInterception(true);
+    page.on("request", async request => {
+        if (request.url() !== "https://google.com/") {
+            // Если урл запроса не матчится на https://google.com/,
+            // то выполняем запрос (т. е. не перехватываем его)
+            return request.continue();
+        }
+
+        // отвечаем своими данными
+        return request.respond({ body: "Hello, world!" });
+    });
+
+    // Здесь можно было бы вызвать и "page.goto('https://google.com')", но лучше вызывать "url",
+    // так как в большинстве плагинов есть обертки команды "url", добавляющие дополнительную
+    // логику. Например, в testplane добавляется урл в мету.
+    await this.browser.url("https://google.com");
+});
+```
+
+### Хардкорный вариант с использованием CDP напрямую {#hardcore_example}
+
+А теперь представим, что в _puppeteer_ еще нет API для мока запросов, но это уже реализовано в домене [Fetch][fetch] CDP. В этом случае воспользуемся методом этого домена через общение с CDP-сессией напрямую. Для этого в _puppeteer_ есть метод [CDPSession.send()][cdp-session-send]:
+
+```javascript
+it("should mock google.com using cdp fetch domain", async function () {
+    // Получаем инстанс puppeteer'а
+    const puppeteer = await this.browser.getPuppeteer();
+
+    // Получаем первую открытую страницу (считаем, что она активная в данный момент)
+    const [page] = await puppeteer.pages();
+
+    // Создаем CDP-сессию
+    const client = await page.target().createCDPSession();
+
+    // Включаем возможность перехватить запрос с помощью подписки на событие "requestPaused"
+    await client.send("Fetch.enable");
+
+    client.on("Fetch.requestPaused", event => {
+        const {
+            request: { url },
+            requestId,
+            responseHeaders,
+        } = event;
+
+        if (url !== "https://google.com/") {
+            // Если урл запроса не матчится на https://google.com/,
+            // то выполняем запрос (т. е. не перехватываем его)
+            return client.send("Fetch.continueRequest", { requestId });
+        }
+
+        // Подменяем ответ на свой и упаковываем его в base64
+        return client.send("Fetch.fulfillRequest", {
+            requestId,
+            responseCode: 200,
+            responseHeaders,
+            body: Buffer.from("Hello, world!", "utf8").toString("base64"),
+        });
+    });
+
+    await this.browser.url("https://google.com");
+});
+```
+
+Очевидно, что при использовании API _webdriverio_ для мока запросов код получается сильно короче, но API _webdriverio_ сильно ограничен и для более сложных кейсов необходимо использовать API puppeteer'а. При этом в самом puppeteer'е тоже может не быть API для каких-то новых методов или доменов CDP. Поэтому в редких случаях может пригодиться общение по CDP напрямую с помощью [CDPSession.send()][cdp-session-send].
+
+## Пример 2: отменяем запрос за логотипом гугла {#example_2}
+
+```javascript
+it("should abort request to logo on google.com", async function () {
+    // В качестве урла можно использовать маску
+    const mock = await this.browser.mock("https://www.google.com/images/**/*.png");
+
+    // Кидаем ошибку "ERR_FAILED" при загрузке ресурса, сматчившегося на маску мока
+    mock.abort("Failed");
+
+    await this.browser.url("https://google.com");
+});
+```
+
+По графическому изображению видно, что логотип не отобразился и в логе присутствует ошибка `net::ERR_FAILED`. Такое решение может быть удобно для отключения каких-то скриптов, которые мешают быстрому выполнению теста. Например, можно отключить сбор аналитики.
+
+## Пример 3: при загрузке google.com берем ответ из фикстуры {#example_3}
+
+```javascript
+it("should mock google.com and return answer from fixture", async function () {
+    // Мокаем поход на google.com
+    const mock = await this.browser.mock("https://google.com");
+
+    // Указываем путь, откуда нужно взять фикстуру, а с помощью
+    // "fetchResponse: false" говорим, что выполнять реальный поход не нужно
+    mock.respond("./fixtures/my-google.com.html", { fetchResponse: false });
+
+    await this.browser.url("https://google.com");
+});
+```
+
+По графическому изображению видно, что вместо выдачи _google.com_ отобразились данные из нашей фикстуры.
+
+## Пример 4: перенаправляем запрос с google.com на yandex.ru {#example_4}
+
+```javascript
+it("should redirect from google.com to yandex.ru", async function () {
+    // Мокаем поход на google.com
+    const mock = await this.browser.mock("https://google.com");
+
+    // Для редиректа необходимо просто указать урл
+    mock.respond("https://yandex.ru");
+
+    await this.browser.url("https://google.com");
+});
+```
+
+## Пример 5: модифицируем ответ от google.com в реальном времени {#example_5}
+
+В _puppeteer_ все еще не реализован API для удобного изменения ответа. Про это есть [issue#1191](https://github.com/puppeteer/puppeteer/issues/1191). Но такая возможность уже поддержана в CDP. Webdriverio использует CDP напрямую через [puppeteer][puppeteer] и, соответственно, в _webdriverio_ это работает.
+
+Заменим в ответе от _google.com_ все строки содержащие `Google` на `Yandex`:
+
+```javascript
+it("should modify response from google.com", async function () {
+    // Тут нужно мокать именно с www, так как переход на google.com
+    // возвращает ответ 301 без body и перенаправляет нас на www
+    const mock = await this.browser.mock("https://www.google.com");
+
+    mock.respond(req => {
+        // С помощью регулярки заменяем "Google" на "Yandex"
+        return req.body.replace(/Google/g, "Yandex");
+    });
+
+    await this.browser.url("https://google.com");
+});
+```
+
+Кроме этого, мы можем видоизменять ответы от заранее неизвестных источников. Например, давайте модифицируем все скрипты, загружаемые на _google.com:_
+
+```javascript
+it("should modify response from google.com", async function () {
+    // Первым аргументом указываем, что будем перехватывать абсолютно все запросы
+    const mock = await this.browser.mock("**", {
+        headers: headers => {
+            // Фильтруем только запросы, в которых заголовок "content-type"
+            // содержит значения "text/javascript" или "application/javascript"
+            return (
+                headers["content-type"] &&
+                /^(text|application)\/javascript/.test(headers["content-type"])
+            );
+        },
+    });
+
+    mock.respond(req => {
+        // В конец каждого скрипта добавляем свой console.log
+        return (req.body += `\nconsole.log("This script was modified in realtime");`);
+    });
+
+    await this.browser.url("https://google.com");
+});
+```
+
+## Пример 6: перехватываем все запросы к ресурсу yandex.ru и собираем список всех загружаемых урлов {#example_6}
+
+Предположим, что нам необходимо собрать список всех урлов, которые загружаются на странице. Используя эту информацию мы могли бы определить, есть ли у нас походы за внешними ресурсами или в соседние сервисы, которые мы никак не контролируем. Это означает, что они в любой момент могут не ответить и сломать нам тесты. Как мог бы выглядеть наш код:
+
+```javascript
+it("should mock yandex.ru and log all loaded urls", async function () {
+    // Перехватываем абсолютно все запросы
+    const mock = await this.browser.mock("**");
+
+    await this.browser.url("https://yandex.ru");
+
+    // mock.calls содержит не только информацию о посещенном урле,
+    // Но также ответ от источника, хэдеры запроса, хэдеры ответа и т. д.
+    const urls = mock.calls.map(({ url }) => url);
+
+    console.log("visited urls:", JSON.stringify(urls, null, "\t"));
+    console.log("count of visited urls:", urls.length);
+});
+```
+
+Скорее всего, ваши тесты сложнее этих примеров и у вас будут различные клики в элементы, которые открываются в новых табах. В таких случаях предыдущий код ничего не узнает об открытии новых вкладок, а также о том, что в них тоже нужно собрать список урлов. Поэтому для такого случая нужно использовать API puppeteer'а:
+
+```javascript
+it("should mock yandex.ru and log all loaded urls (using puppeteer)", async function () {
+    // В этой переменной будем накапливать список всех урлов
+    const urls = [];
+
+    // Хелпер, который на вход ожидает инстанс страницы из puppeteer:
+    // https://pptr.dev/#?product=Puppeteer&version=v10.1.0&show=api-class-page
+    function urlsHandler(page) {
+        // Подписываемся на все запросы, которые будут происходить на переданной странице
+        page.on("request", req => {
+            urls.push(req.url());
+        });
+    }
+
+    // Получаем инстанс puppeteer'а
+    const puppeteer = await this.browser.getPuppeteer();
+
+    // Получаем все открытые страницы на текущий момент
+    const pages = await puppeteer.pages();
+
+    // Подписываемся на все запросы, которые будут происходить на этих страницах
+    await Promise.all(pages.map(p => urlsHandler(p)));
+
+    // Подписываемся на открытие новой страницы
+    puppeteer.on("targetcreated", async target => {
+        // Проверяем, что открытый таргет, действительно, является новой страницей
+        const page = await target.page();
+
+        if (!page) {
+            return;
+        }
+
+        // Так как новая страница открывается уже с каким-то урлом,
+        // то его необходимо записывать явно (подписка на запрос его не обнаружит)
+        urls.push(target.url());
+
+        // Подписываемся на все запросы, которые будут происходить на новой вкладке
+        urlsHandler(page);
+    });
+
+    await this.browser.url("https://yandex.ru");
+
+    // Находим первым элемент в списке сервисов (на тот момент была страница с футболом)
+    const elem = await this.browser.$(".services-new__list-item > a");
+
+    // Выполняем клик в сервис, который открывается в новой вкладке
+    await elem.click();
+
+    console.log("visited urls:", JSON.stringify(urls, null, "\t"));
+    console.log("count of visited urls:", urls.length);
+});
+```
+
+## Пример 7: мокаем ресурс google.com во всех тестах Хрома {#example_7}
+
+Для того, чтобы не мокать одни и те же ресурсы явно во всех тестах, можно воспользоваться плагином [testplane-global-hook][testplane-global-hook]. Настроив его соответствующим образом в конфиге testplane:
+
+```javascript
+// .testplane.conf.js
+module.exports = {
+    plugins: {
+        "testplane-global-hook": {
+            enabled: true,
+
+            beforeEach: async function () {
+                // Проверяем, что имя браузера не начинается на "chrome"
+                if (!/^chrome$/i.test(this.browser.capabilities.browserName)) {
+                    return;
+                }
+
+                // Мокаем поход на google.com
+                const mock = await this.browser.mock("https://google.com");
+                mock.respond("hello world", { fetchResponse: false });
+            },
+
+            afterEach: function () {
+                // Очищаем все моки в текущей сессии
+                this.browser.mockRestoreAll();
+            },
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+А код теста теперь будет содержать только переход по URL:
+
+```javascript
+// Явно укажем, чтобы тест выполнялся только в браузерах, название которых начинается с chrome
+testplane.only.in(/^chrome/);
+it("should mock google.com inside global before each", async function () {
+    await this.browser.url("https://google.com");
+});
+```
+
+## Полезные ссылки {#useful_links}
+
+Ещё примеры использования можно посмотреть в руководстве "[Mocks and Spies][wdio-mocks-and-spies]" на сайте _webdriverio._
+
+[how-to-use-cdp]: ./how-to-use-cdp
+[wdio-mocks-and-spies]: https://webdriver.io/docs/mocksandspies/
+[fetch]: https://chromedevtools.github.io/devtools-protocol/tot/Fetch/
+[network]: https://chromedevtools.github.io/devtools-protocol/tot/Network/
+[mock]: ../commands/browser/mock
+[get-puppeteer]: ../commands/browser/getPuppeteer
+[cdp-session-send]: https://pptr.dev/next/api/puppeteer.cdpsession.send
+[testplane-global-hook]: ../plugins/testplane-global-hook
diff --git a/docs/guides/how-to-manage-cpu-performance.mdx b/docs/guides/how-to-manage-cpu-performance.mdx
new file mode 100644
index 0000000..5bef937
--- /dev/null
+++ b/docs/guides/how-to-manage-cpu-performance.mdx
@@ -0,0 +1,64 @@
+import Admonition from "@theme/Admonition";
+
+# Как управлять быстродействием процессора
+
+## Обзор {#overview}
+
+<Admonition type="warning">
+Данный рецепт работает только при использовании _Chrome DevTools Protocol (CDP)_.
+
+Читайте подробности в разделе «[Как использовать CDP в Testplane][how-to-use-cdp]»
+
+</Admonition>
+
+Скорость работы процессора на мобильных устройствах сильно уступает скорости на компьютерах. Поэтому для эмуляции скорости CPU в _puppeteer_ существует метод [emulateCPUThrottling][emulate-cpu-throttling].
+
+## Пример: замедляем скорость процессора в 8 раз {#example}
+
+Воспользуемся этим методом, чтобы замедлить скорость процессора в 8 раз:
+
+```javascript
+it("should open yandex.ru with emulation 8x slower CPU", async function () {
+    // Получаем инстанс puppeteer'а
+    const puppeteer = await this.browser.getPuppeteer();
+
+    // Получаем первую открытую страницу (считаем, что она активная в данный момент)
+    const [page] = await puppeteer.pages();
+
+    // Замедляем скорость процессора в 8 раз
+    await page.emulateCPUThrottling(8);
+
+    await this.browser.url("https://yandex.ru");
+});
+```
+
+## Небольшая история об одном обходном пути {#workaround_in_the_past}
+
+Изначально в _webdriverio_ не было поддержки метода `page.emulateCPUThrottling`, так как в _webdriverio_ использовалась версия _puppeteer-core@9.1.0,_ а не _puppeteer-core@10.1.0_, в которой этот метод был поддержан.
+
+Однако это ограничение можно было обойти с помощью метода _puppeteer_ [CDPSession.send()][cdp-session-send], отправив браузеру команду [Emulation.setCPUThrottlingRate][emulation-set-cpu-throttling-rate] по CDP:
+
+```javascript
+it("should open yandex.ru with emulation 8x slower CPU", async function () {
+    // Получаем инстанс puppeteer'а
+    const puppeteer = await this.browser.getPuppeteer();
+
+    // Получаем первую открытую страницу (считаем, что она активная в данный момент)
+    const [page] = await puppeteer.pages();
+
+    // Создаем CDP-сессию
+    const client = await page.target().createCDPSession();
+
+    // Замедляем скорость процессора в 8 раз
+    await client.send("Emulation.setCPUThrottlingRate", { rate: 8 });
+
+    await this.browser.url("https://yandex.ru");
+});
+```
+
+Позже мы донесли в _webdriverio_ необходимый [пулл-реквест](https://github.com/webdriverio/webdriverio/pull/7135) с апдейтом версии _puppeteer-core_ и теперь метод [emulateCPUThrottling][emulate-cpu-throttling] доступен в testplane прямо из коробки.
+
+[how-to-use-cdp]: ./how-to-use-cdp
+[emulate-cpu-throttling]: https://pptr.dev/api/puppeteer.page.emulatecputhrottling
+[cdp-session-send]: https://pptr.dev/api/puppeteer.cdpsession.send
+[emulation-set-cpu-throttling-rate]: https://chromedevtools.github.io/devtools-protocol/tot/Emulation/#method-setCPUThrottlingRate
diff --git a/docs/guides/how-to-manage-network-bandwidth.mdx b/docs/guides/how-to-manage-network-bandwidth.mdx
new file mode 100644
index 0000000..745714c
--- /dev/null
+++ b/docs/guides/how-to-manage-network-bandwidth.mdx
@@ -0,0 +1,58 @@
+import Admonition from "@theme/Admonition";
+
+# Как управлять пропускной способностью сети
+
+## Обзор {#overview}
+
+<Admonition type="warning">
+Данный рецепт работает только при использовании _Chrome DevTools Protocol (CDP)_.
+
+Читайте подробности в разделе «[Как использовать CDP в Testplane][how-to-use-cdp]».
+
+</Admonition>
+
+Огромное количество пользователей пользуются сервисами с мобильных устройств, на которых скорость интернета бывает довольно медленной или совсем пропадает на время. В _webdriverio_ мы можем ограничить пропускную способность сети с помощью метода [throttle][throttle] и таким образом протестировать поведение сайта в сетях с разной пропускной способностью.
+
+Помимо индивидуальных настроек метод [throttle][throttle] поддерживает следующие готовые пресеты:
+
+-   offline | online
+-   GPRS
+-   Regular2G | Good2G
+-   Regular3G | Good3G
+-   Regular4G
+-   DSL
+-   WiFi
+
+## Пример 1: эмуляция 2G-соединения {#example_1}
+
+Сэмулируем 2G-соединение и откроем yandex.ru в Хроме с эмуляцией телефона:
+
+```javascript
+it("should open yandex.ru with emulation of 2G-connection", async function () {
+    // Имитируем 2G-соединение
+    await this.browser.throttle("Good2G");
+
+    await this.browser.url("https://yandex.ru");
+});
+```
+
+## Пример 2: эмуляция сети с заданными характеристиками {#example_2}
+
+Также мы можем сэмулировать соединение с конкретными характеристиками:
+
+```javascript
+it("should open yandex.ru with emulation of custom connection", async function () {
+    // Имитируем соединение в сети с заданными характеристиками
+    await this.browser.throttle({
+        offline: false, // имитация отключения от интернета
+        downloadThroughput: (10 * 1024) / 8, // максимальная пропускная способность загрузки (byte/sec)
+        uploadThroughput: (10 * 1024) / 8, // максимальная пропускная способность отправки (byte/sec)
+        latency: 10, // минимальная задержка от отправки запроса до получения заголовков ответа
+    });
+
+    await this.browser.url("https://yandex.ru");
+});
+```
+
+[how-to-use-cdp]: ./how-to-use-cdp
+[throttle]: ../commands/browser/throttle
diff --git a/docs/guides/how-to-minify-screenshots.mdx b/docs/guides/how-to-minify-screenshots.mdx
new file mode 100644
index 0000000..20d8e99
--- /dev/null
+++ b/docs/guides/how-to-minify-screenshots.mdx
@@ -0,0 +1,36 @@
+import Admonition from "@theme/Admonition";
+
+# Как уменьшить вес скриншотов
+
+## Введение {#preface}
+
+Одна из ключевых функций testplane — это возможность тестировать верстку с помощью скриншотов. Для этого в тестах, при разных состояниях веб-страницы, можно снять скриншот и сравнить его с эталонным.
+
+Пример такого сравнения:
+
+![Сравнение скриншотов](/img/docs/guides/how-to-minify-screenshots.diff-in-screenshot.png)
+
+<Admonition type="info" title="Для новичков">
+**Откуда берутся эталонные скриншоты?**
+
+Вы написали тест с использованием команды testplane _assertView_. Команда _assertView_ сравнивает актуальный скриншот с эталонным. Актуальный скриншот — это скриншот, который тест делает во время своего прогона. Он отражает текущее состояние вашей веб-страницы. При первом прогоне вашего теста эталонного скриншота у вас ещё нет. А значит команда _assertView_ упадет с сообщением, что эталонный скриншот не найден. При этом у вас будет актуальный скриншот. Если актуальный скриншот отражает то состояние вашей веб-страницы, которое вы ожидаете (считаете эталонным), то вам нужно _принять (accept)_ актуальный скриншот в качестве эталонного. Чтобы это сделать нужно запускать testplane с дополнительной опцией _--update-refs_. Или же воспользоваться режимом GUI, который предоставляет плагин _html-reporter_. С помощью него вы можете просматривать отчет о прогоне в GUI-режиме, убеждаться, что актуальные скриншоты именно такие, как вы ожидаете, и принимать их с помощью кнопки _Accept_.
+
+</Admonition>
+
+## Проблема {#problem}
+
+Если в вашем проекте много тестов, в которых используется валидация верстки с помощью скриншотов, то значит, в вашем проекте будет много скриншотов. Иногда эти скриншоты — довольно большие и могут занимать много места на файловой системе.
+
+Если в проекте идет активная разработка, то на каждый пулл-реквест будет формироваться свой отчет о прогоне тестов, в котором будут содержаться сотни (или тысячи) эталонных скриншотов. Чем больше вес скриншотов, тем больше будут весить ваши отчеты. А значит — дольше скачиваться, занимать больше места на диске и т. д.
+
+## Решение: testplane-image-minifier {#solution}
+
+Чтобы уменьшить место, которое скриншоты занимают на диске, подключите в своем проекте плагин [testplane-image-minifier][testplane-image-minifier]. Данный плагин поддерживает 8 степеней сжатия изображений без потерь.
+
+Как подключить и настроить плагин читайте в [документации][testplane-image-minifier] плагина.
+
+## Ключевые слова {#keywords}
+
+-   testplane-image-minifier
+
+[testplane-image-minifier]: ../plugins/testplane-image-minifier
diff --git a/docs/guides/how-to-mitigate-flaky-tests.mdx b/docs/guides/how-to-mitigate-flaky-tests.mdx
new file mode 100644
index 0000000..02d6632
--- /dev/null
+++ b/docs/guides/how-to-mitigate-flaky-tests.mdx
@@ -0,0 +1,7 @@
+# Как победить нестабильные тесты
+
+## Ключевые слова {#keywords}
+
+-   testplane-muted-tests
+-   testplane-retry-command
+-   testplane-retry-progressive
diff --git a/docs/guides/how-to-optimize-test-code.mdx b/docs/guides/how-to-optimize-test-code.mdx
new file mode 100644
index 0000000..9336b35
--- /dev/null
+++ b/docs/guides/how-to-optimize-test-code.mdx
@@ -0,0 +1,23 @@
+# Как избавиться от дублирования в тестах
+
+## Проблема {#problem}
+
+Часто, перед тем как запустить очередной testplane-тест, нужно выполнить определенную подготовительную работу, например:
+
+-   очистить все cookies;
+-   почистить localStorage;
+-   инициализировать какую-либо переменную теста.
+
+Аналогично, после завершения основных проверок в testplane-тесте, вы можете захотеть всегда проверять наличие ошибок в клиентском коде, срабатывание нужных метрик и т. п.
+
+## Решение: testplane-global-hook {#solution}
+
+Чтобы не повторять эти действия каждый раз в своих тестах, подключите плагин [testplane-global-hook][testplane-global-hook] и опишите их в настройках плагина в виде функций для хуков `beforeEach` и `afterEach`.
+
+Подробнее о том, как подключить и настроить плагин, читайте в [документации][testplane-global-hook] плагина.
+
+## Ключевые слова {#keywords}
+
+-   testplane-global-hook
+
+[testplane-global-hook]: ../plugins/testplane-global-hook
diff --git a/docs/guides/how-to-optimize-test-running.mdx b/docs/guides/how-to-optimize-test-running.mdx
new file mode 100644
index 0000000..3544291
--- /dev/null
+++ b/docs/guides/how-to-optimize-test-running.mdx
@@ -0,0 +1,9 @@
+# Как ускорить прогон тестов
+
+## Ключевые слова {#keywords}
+
+-   testsPerSession
+-   sessionsPerBrowser
+-   workers
+-   testplane-chunks
+-   retry-limiter
diff --git a/docs/guides/how-to-profile-tests.mdx b/docs/guides/how-to-profile-tests.mdx
new file mode 100644
index 0000000..0de3423
--- /dev/null
+++ b/docs/guides/how-to-profile-tests.mdx
@@ -0,0 +1,6 @@
+# Как проанализировать скорость тестов
+
+## Ключевые слова {#keywords}
+
+-   testplane-profiler
+-   testplane-plugins-profiler
diff --git a/docs/guides/how-to-remove-useless-screenshots.mdx b/docs/guides/how-to-remove-useless-screenshots.mdx
new file mode 100644
index 0000000..64d6008
--- /dev/null
+++ b/docs/guides/how-to-remove-useless-screenshots.mdx
@@ -0,0 +1,5 @@
+# Как удалить лишние скриншоты
+
+## Ключевые слова {#keywords}
+
+-   html-reporter
diff --git a/docs/guides/how-to-run-specified-test.mdx b/docs/guides/how-to-run-specified-test.mdx
new file mode 100644
index 0000000..5cfba56
--- /dev/null
+++ b/docs/guides/how-to-run-specified-test.mdx
@@ -0,0 +1,51 @@
+# Как запустить конкретные тесты
+
+## Проблема {#problem}
+
+Иногда вам может потребоваться запустить конкретные тесты, а не весь набор тестов, которые есть в вашем проекте.
+
+Например, вы разработали какую-либу фичу и покрыли ее функциональными тестами. И хотите в первую очередь проверить корректность выполнения новых тестов.
+
+Или вы чините плавающий тест, нашли в нем баги, исправили их и хотите проверить, что теперь тест корректно проходит.
+
+## Решение 1: запуск конкретного файла {#solution_1}
+
+Если вы хотите запустить всю группу тестов, которые находятся в конкретном файле, то укажите путь к этому файлу в качестве входного параметра для testplane:
+
+```bash
+testplane src/features/Reviews/Reviews.test/MyReview/MyReview.a11y@touch-phone.testplane.js
+```
+
+## Решение 2: опция --grep {#solution_2}
+
+Если же вы хотите запустить конкретный тест, то воспользуйтесь опцией `--grep`, указав в качестве ее значения полное имя теста:
+
+```bash
+testplane --grep "Доступность Оставление отзыва"
+```
+
+## Решение 3: директива .only {#solution_3}
+
+Ещё вы можете воспользоваться директивой `.only` для набора тестов `describe` и конкретного теста `it`, аналогично тому как это реализовано в `mocha` (см. раздел [exlusive tests](https://mochajs.org/#exclusive-tests)):
+
+Например:
+
+```javascript
+describe.only("Доступность", function () {
+    // набор тестов...
+});
+```
+
+или
+
+```javascript
+it.only("Оставление отзыва", async function () {
+    // код теста...
+});
+```
+
+## Ключевые слова {#keywords}
+
+-   grep
+-   describe.only
+-   it.only
diff --git a/docs/guides/how-to-skip-test-in-browsers.mdx b/docs/guides/how-to-skip-test-in-browsers.mdx
new file mode 100644
index 0000000..01fcfae
--- /dev/null
+++ b/docs/guides/how-to-skip-test-in-browsers.mdx
@@ -0,0 +1,70 @@
+# Как пропустить тест в заданном браузере
+
+## Проблема {#problem}
+
+Иногда вам нужно пропустить запуск теста только в определенном браузере, а не во всех браузерах. То есть вы не хотели бы отключать или удалять весь тест, а хотели бы только ограничить количество браузеров, на которых он будет запускаться.
+
+Например, это может быть связано с ограниченной функциональностью соответствующего браузера: отсутствием в нем необходимых возможностей, которые используются на веб-странице и проверяются тестом.
+
+Ещё такая необходимость может возникнуть при нестабильной работе теста в каком-либо браузере, из-за неучета каких-то особенностей реализации в браузере.
+
+В testplane вы можете сделать это с помощью специальных хелперов (директив) `skip` и `only`.
+
+## Решение 1: директива .skip.in {#solution_1}
+
+Например, если вы не хотите запускать тест в браузере `IE8`:
+
+```javascript
+describe("feature", function () {
+    testplane.skip.in("ie8", "it cannot work in this browser");
+    it("nowaday functionality", function () {
+        // ...
+    });
+});
+```
+
+При использовании директивы `testplane.skip.in` вы увидите в отчете сообщение о том, что запуск в соответствующем браузере был пропущен.
+
+Чтобы пропустить запуск тестов без уведомлений в отчете, вы можете передать хелперу специальный флаг `silent` в качестве третьего аргумента:
+
+```javascript
+testplane.skip.in("ie8", "skipReason", { silent: true });
+```
+
+## Решение 2: директива .skip.notIn {#solution_2}
+
+Также вы можете захотеть запускать тест только в конкретном браузере, например, в `Chrome`:
+
+```javascript
+describe("feature", function () {
+    testplane.skip.notIn("chrome", "it should work only in Chrome");
+    it("specific functionality", function () {
+        // ...
+    });
+});
+```
+
+Аналогично, чтобы избавиться от уведомлений в отчете, вы можете передать хелперу специальный флаг `silent` в качестве третьего аргумента:
+
+```javascript
+testplane.skip.notIn("chrome", "skipReason", { silent: true });
+```
+
+## Решение 3: директивы .only.in и .only.notIn {#solution_3}
+
+Ещё вы можете воспользоваться хелперами `only.in` и `only.notIn`, логика которых противоположна хелперам `skip.in` и `.skip.notIn`. Плюс эти хелперы по умолчанию не выводят никаких уведомлений в отчете:
+
+```javascript
+testplane.only.in("chrome"); // запустить тест только в chrome
+```
+
+```javascript
+testplane.only.notIn("ie8"); // запустить тест во всех браузерах, кроме ie8
+```
+
+## Ключевые слова {#keywords}
+
+-   testplane.skip.in
+-   testplane.skip.notIn
+-   testplane.only.in
+-   testplane.only.notIn
diff --git a/docs/guides/how-to-update-browsers.mdx b/docs/guides/how-to-update-browsers.mdx
new file mode 100644
index 0000000..43cdb05
--- /dev/null
+++ b/docs/guides/how-to-update-browsers.mdx
@@ -0,0 +1,92 @@
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+import Admonition from "@theme/Admonition";
+
+# Как обновлять браузеры в больших проектах
+
+## Проблема
+
+В большом проекте, над которым работают несколько команд, как правило, много тестов. И тогда обновление браузеров в проекте превращается в настоящую головную боль. Ведь изменение версии браузера часто требует переснятия скриншотов, так как в браузере могут меняться механизмы рендеринга, анимации, антиалиасинга и пр. Достаточно малейшего изменения во внутренней реализации рендеринга в браузере, чтобы это привело к появлению диффов между эталонными и актуальными скриншотами в тестах.
+
+Пересняв тысячи скриншотов, разработчик создает пулл-реквест, который ему надо влить в главную ветку проекта. И влитие такого пулл-реквеста становится крайне сложной задачей из-за постоянно возникающих мерж-конфликтов. Так как разработка не стоит на месте, и какие-то команды в это время меняют тесты: переснимают эталонные скриншоты, чтобы учесть внедрение новой функциональности, или удаляют неактуальные тесты, и, соответственно, их скриншоты. А значит, пулл-реквест с большим количеством измененных файлов будет быстро устаревать и требовать постоянного ребейза относительно главной ветки проекта. При чем этот ребейз требует целого ряда действий: нужно не только обновить кодовую базу, но и заново запустить соответствующие тесты, чтобы переснять скриншоты. Так как простым выбором «правильной» стороны мерж-конфликта между скриншотами здесь не обойтись. Оба скриншота при мерж-конфликте будут неправильными: один — устаревшим, а другой — не соответствующим новой версии браузера.
+
+Таким образом, если какая-либо команда хочет обновить версию браузера, в котором прогоняются её тесты, она вынуждена обновлять тесты для всего проекта и сталкиваться во всеми описанными выше трудностями.
+
+Есть 3 варианта решения данной проблемы.
+
+## Решение 1: testplane.browser().version()
+
+Testplane позволяет переопределить версию браузера для конкретного теста или набора тестов с помощью специального хелпера `testplane.browser().version()`.
+
+Например:
+
+```javascript
+// Переопределяем версию браузера chrome-desktop на 70.3 для всего набора тестов
+testplane.browser("chrome-desktop").version("70.3");
+describe("suite", function () {
+    it("test 1", function () {
+        // ...
+    });
+
+    // Переопределяем версию браузера chrome-desktop на 70.1 для конкретного теста
+    testplane.browser("chrome-desktop").version("70.1");
+    it("test 2", function () {
+        // ...
+    });
+});
+```
+
+Недостаток такого подхода заключается в том, что нужно вручную изменять файлы самих тестов. При большом количестве файлов это может занять довольно длительное время.
+
+## Решение 2: Browser Version Changer
+
+Можно воспользоваться плагином [hermione-browser-version-changer][hermione-browser-version-changer], который позволяет определять версию браузера для конкретного теста на основе специального словаря _(store)_ и предикатов для всех доступных в проекте версий браузеров.
+
+Пример использования плагина:
+
+```javascript
+module.exports = {
+    plugins: {
+        "hermione-browser-version-changer": {
+            enabled: true,
+            initStore: async () => {
+                // Подготавливаем словарь с произвольными признаками для разметки
+                return {
+                    "title-test1": "tag1",
+                    "title-test2": "tag1",
+                    "title-test3": "tag2",
+                };
+            },
+            browsers: {
+                "chrome-desktop": {
+                    // Ключ "70.1" – версия браузера, значение – предикат
+                    // Если функция вернет истинное значение, для браузера установится данная версия
+                    70.1: (test, version, store) => {
+                        // test – текущий тест
+                        // version – предлагаемая версия "70.1"
+                        // store – словарь, который был подготовлен в методе initStore
+
+                        // Установить версию браузера 70.1, если тест относится к "tag1"
+                        return store[test.title] === "tag1";
+                    },
+                    80: (test, version, store) => {
+                        return store[test.title] === "tag2";
+                    },
+                },
+            },
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+Приведенный пример — очень условный и, вполне возможно, что в вашем проекте вам даже не понадобится использовать _store_, а хватит проверки соответствия теста заданному паттерну регулярного выражения.
+
+[hermione-browser-version-changer]: ../plugins/hermione-browser-version-changer
+[testplane]: https://github.com/gemini-testing/testplane
+[html-reporter]: ../html-reporter/html-reporter-setup
+[gh-issues]: https://github.com/gemini-testing/testplane/issues/
diff --git a/docs/guides/how-to-use-cdp.mdx b/docs/guides/how-to-use-cdp.mdx
new file mode 100644
index 0000000..e151dca
--- /dev/null
+++ b/docs/guides/how-to-use-cdp.mdx
@@ -0,0 +1,118 @@
+import Admonition from "@theme/Admonition";
+
+# Как использовать Chrome DevTools Protocol в testplane
+
+## Введение {#preface}
+
+<Admonition type="warning">
+    Установите в своем проекте testplane 4-й версии и выше, чтобы использовать _Chrome DevTools
+    Protocol (CDP)_ в testplane-тестах.
+</Admonition>
+
+Протокол `WebDriver` используется в testplane уже давно, а вот возможность использования [CDP][CDP] появилась только после переезда на _[WebdriverIO@7](https://webdriver.io/versions)_ в testplane 4-й версии.
+
+Поддержка CDP в _WebdriverIO@7_ реализована с помощью [puppeteer][puppeteer]. Который, в свою очередь, является оберткой с удобным API над CDP.
+
+Про сравнение протоколов _WebDriver_ и _CDP_ читайте в разделе Справочника «[WebDriver vs CDP][webdriver-vs-cdp]».
+
+## Локальное использование {#local_usage}
+
+Для работы с браузером по CDP локально — добавьте опцию `automationProtocol: 'devtools'` к настройкам браузера в конфиге testplane:
+
+```javascript
+// .testplane.conf.js
+
+module.exports = {
+    browsers: {
+        chrome: {
+            automationProtocol: "devtools",
+            desiredCapabilities: {
+                // ...
+            },
+        },
+
+        // настройки других браузеров...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+После этого все последующие запуски будут выполняться в вашем локально установленном Хроме.
+
+Но если вам нужно запустить браузер с поддержкой CDP один раз, то удобнее переопределить эту опцию с помощью переменной окружения:
+
+```bash
+testplane_browsers_chrome_automation_protocol=devtools npx testplane ...
+```
+
+Или задать её в виде опции CLI:
+
+```bash
+npx testplane ... --browsers-chrome-automation-protocol=devtools
+```
+
+## Удаленное использование {#remote_usage}
+
+При использовании CDP на удаленной машине (например, в гриде) testplane сначала поднимет браузер с использованием WebDriver-протокола и только потом, по запросу пользователя (т. е. при вызове CDP-команды), перейдет на подключение по CDP. Таким образом, с удаленным браузером в одном тестовом сценарии мы будем общаться сразу по двум протоколам.
+
+Выглядит это примерно так:
+
+![Схема удаленного использования CDP](/img/docs/guides/how-to-use-cdp.remote-scheme.png)
+
+Чтобы подключиться по CDP к удаленному браузеру необходимо:
+
+-   использовать `automationProtocol: webdriver` (значение по умолчанию);
+-   в `desiredCapabilities` браузера добавить вендорное поле `selenoid:options`: данная опция необходима, чтобы _webdriverio_ понял, что нужно подключиться именно к удаленной машине, а не к локальному браузеру.
+
+```javascript
+// .testplane.conf.js
+
+module.exports = {
+    browsers: {
+        chrome: {
+            desiredCapabilities: {
+                "selenoid:options": {},
+                // ...
+            },
+
+            // другие настройки браузера...
+        },
+
+        // настройки других браузеров...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+<Admonition type="warning" title="Ограничения">
+    Полноценно использовать CDP можно только начиная с **Chrome@77** и выше. Это связано с
+    внутренней реализацией в _webdriverio._
+</Admonition>
+
+## Какие возможности открывает CDP {#what_does_cdp_give}
+
+С помощью CDP вы можете:
+
+-   [отслеживать и перехватывать сетевые запросы и ответы][how-to-intercept-requests-and-responses]
+-   [тестировать доступность (accessibility) страницы][how-to-check-accessibility]
+-   [управлять пропускной способностью сети][how-to-manage-network-bandwidth]
+-   [управлять быстродействием процессора][how-to-manage-cpu-performance]
+-   [скрывать скроллбары][how-to-hide-scrollbars-by-cdp]
+
+## Полезные ссылки {#useful_links}
+
+-   [WebDriver vs CDP][webdriver-vs-cdp]
+-   [Web Performance Recipes With Puppeteer](https://addyosmani.com/blog/puppeteer-recipes/)
+-   [Про Chrome DevTools Protocol][CDP]
+-   [puppeteer][puppeteer]
+
+[CDP]: https://chromedevtools.github.io/devtools-protocol/
+[puppeteer]: https://pptr.dev/
+[how-to-intercept-requests-and-responses]: ./how-to-intercept-requests-and-responses
+[how-to-check-accessibility]: ./how-to-check-accessibility
+[how-to-manage-network-bandwidth]: ./how-to-manage-network-bandwidth
+[how-to-manage-cpu-performance]: ./how-to-manage-cpu-performance
+[how-to-hide-scrollbars-by-cdp]: ./how-to-hide-scrollbars-by-cdp
+[webdriver-vs-cdp]: ../reference/webdriver-vs-cdp
diff --git a/docs/guides/how-to-write-your-own-plugin.mdx b/docs/guides/how-to-write-your-own-plugin.mdx
new file mode 100644
index 0000000..785d3ae
--- /dev/null
+++ b/docs/guides/how-to-write-your-own-plugin.mdx
@@ -0,0 +1 @@
+# Как написать свой собственный плагин для testplane
diff --git a/docs/html-reporter/html-reporter-api.mdx b/docs/html-reporter/html-reporter-api.mdx
new file mode 100644
index 0000000..c7418ff
--- /dev/null
+++ b/docs/html-reporter/html-reporter-api.mdx
@@ -0,0 +1,216 @@
+# API плагина
+
+## Обзор {#overview}
+
+Html-reporter добавляет к объекту `testplane` объект `htmlReporter` со своим API.
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[events](#events)</td><td>Object</td><td>Список событий, на которые можно подписаться.</td></tr>
+<tr><td>[extraItems](#extraitems)</td><td>Object</td><td>Дополнительные элементы, которые будут добавлены в бургер-меню отчета.</td></tr>
+<tr><td>[imagesSaver](#imagessaver)</td><td>Object</td><td>Интерфейс для сохранения изображений в хранилище пользователя.</td></tr>
+<tr><td>[reportsSaver](#reportssaver)</td><td>Object</td><td>Интерфейс для сохранения sqlite баз данных в хранилище пользователя.</td></tr>
+<tr><td>[addExtraItem](#addextraitem)</td><td>Method</td><td>Добавляет дополнительный пункт в бургер-меню отчета.</td></tr>
+<tr><td>[downloadDatabases](#downloaddatabases)</td><td>Method</td><td>Скачивает все базы данных из переданных файлов типа _databaseUrls.json_.</td></tr>
+<tr><td>[mergeDatabases](#mergedatabases)</td><td>Method</td><td>Объединяет все переданные базы данных и сохраняет итоговый отчет по заданному пути.</td></tr>
+<tr><td>[getTestsTreeFromDatabase](#getteststreefromdatabase)</td><td>Method</td><td>Возвращает дерево тестов из переданной базы данных.</td></tr>
+
+</tbody>
+</table>
+
+## events
+
+Список событий, на которые можно подписаться.
+
+Смотрите подробнее в разделе «[События отчета](./html-reporter-events)».
+
+## extraItems
+
+Дополнительные элементы, которые будут добавлены в бургер-меню отчета.
+
+Для добавления элементов используйте метод [addExtraItem](#addextraitem).
+
+## imagesSaver
+
+Интерфейс для сохранения изображений в хранилище пользователя.
+
+### Пример использования {#images_saver_usage_example}
+
+```javascript
+const MyStorage = require("my-storage");
+const myStorage = new MyStorage();
+
+module.exports = (testplane, opts) => {
+    testplane.on(testplane.events.INIT, async () => {
+        testplane.htmlReporter.imagesSaver = {
+            /**
+             * Сохранить изображение в пользовательское хранилище.
+             * Функция может быть как асинхронной, так и синхронной.
+             * Функция должна возвращать путь или URL к сохраненному изображению.
+             * @property {String} localFilePath – путь к изображению на файловой системе
+             * @param {Object} options
+             * @param {String} options.destPath – путь к изображению в html-отчете
+             * @param {String} options.reportDir - путь к папке html-отчета
+             * @returns {String} путь или URL к изображению
+             */
+            saveImg: async (localFilePath, options) => {
+                const { destPath, reportDir } = options;
+                const imageUrl = await myStorage.save(localFilePath, destPath, reportDir);
+
+                // ...
+
+                return imageUrl;
+            },
+        };
+    });
+};
+```
+
+## reportsSaver
+
+Интерфейс для сохранения sqlite баз данных в хранилище пользователя.
+
+### Пример использования {#reports_saver_usage_example}
+
+```javascript
+const MyStorage = require("my-storage");
+const myStorage = new MyStorage();
+
+module.exports = (testplane, opts) => {
+    testplane.on(testplane.events.INIT, async () => {
+        testplane.htmlReporter.reportsSaver = {
+            /**
+             * Сохранить sqlite базу данных в пользовательское хранилище.
+             * Функция может быть как асинхронной, так и синхронной.
+             * Функция должна возвращать путь или URL к сохраненной sqlite базе данных.
+             * @property {String} localFilePath – путь к sqlite базе данных на файловой системе
+             * @param {Object} options
+             * @param {String} options.destPath – путь к sqlite базе данных в html-отчете
+             * @param {String} options.reportDir - путь к папке html-отчета
+             * @returns {String} путь или URL к сохраненной sqlite базе данных
+             */
+            saveReportData: async (localFilePath, options) => {
+                const { destPath, reportDir } = options;
+                const dbUrl = await myStorage.save(localFilePath, destPath, reportDir);
+
+                // ...
+
+                return dbUrl;
+            },
+        };
+    });
+};
+```
+
+## addExtraItem
+
+Добавляет дополнительный пункт в виде ссылки в бургер-меню html-отчета.
+
+### Пример вызова {#add_extra_item_call_example}
+
+```javascript
+testplane.htmlReporter.addExtraItem(caption, url);
+```
+
+### Параметры вызова {#add_extra_item_call_params}
+
+Все параметры являются обязательными.
+
+<table>
+<thead>
+<tr><td>**Имя&nbsp;параметра**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>caption</td><td>String</td><td>Название пункта, который надо добавить в бургер-меню.</td></tr>
+<tr><td>url</td><td>String</td><td>URL, на который будет ссылаться добавляемый пункт меню.</td></tr>
+
+</tbody>
+</table>
+
+## downloadDatabases
+
+Скачивает все базы данных из переданных файлов `databaseUrls.json`.
+
+### Пример вызова {#download_databases_call_example}
+
+```javascript
+const dbPaths = await testplane.htmlReporter.downloadDatabases([".databaseUrls.json"], {
+    pluginConfig,
+});
+```
+
+### Параметры вызова {#download_databases_call_params}
+
+Функция принимает 2 аргумента — список путей до файлов `databaseUrls.json` в виде массива строк и объект с ключом `pluginConfig`, в значении которого хранится конфиг плагина.
+
+Функция возвращает список путей к сохраненным базам данных.
+
+## mergeDatabases
+
+Объединяет все переданные базы данных и сохраняет итоговый отчет по заданному пути.
+
+### Пример вызова {#merge_databases_call_example}
+
+```javascript
+await testplane.htmlReporter.mergeDatabases(srcDbPaths, path);
+```
+
+### Параметры вызова {#merge_databases_call_params}
+
+<table>
+<thead>
+<tr><td>**Имя&nbsp;параметра**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>srcDbPaths</td><td>String[]</td><td>Пути к базам данных.</td></tr>
+<tr><td>path</td><td>String</td><td>Путь, по которому будет сохранена итоговая база данных.</td></tr>
+
+</tbody>
+</table>
+
+## getTestsTreeFromDatabase
+
+Возвращает дерево тестов из переданной базы данных.
+
+### Пример вызова {#get_tests_tree_from_database_call_example}
+
+```javascript
+const dbTree = testplane.htmlReporter.getTestsTreeFromDatabase(mergedDbPath);
+```
+
+### Параметры вызова {#get_tests_tree_from_database_call_params}
+
+Функция принимает один аргумент — путь к базе данных с результатом прогона тестов.
+
+### Пример использования {#get_tests_tree_from_database_usage_example}
+
+```javascript
+function getSuccessTestRunIds({ testplane, mergedDbPath }) {
+    const dbTree = testplane.htmlReporter.getTestsTreeFromDatabase(mergedDbPath);
+
+    const successTestRunIds = [];
+
+    for (const browserId of dbTree.browsers.allIds) {
+        const browser = dbTree.browsers.byId[browserId];
+        const lastResultId = _.last(browser.resultIds);
+        const lastResult = lastResultId && dbTree.results.byId[lastResultId];
+
+        if (!lastResult || lastResult.status !== SUCCESS) {
+            continue;
+        }
+
+        const testRunId = new URL(lastResult.suiteUrl).searchParams.get("testRunId");
+
+        if (!testRunId) {
+            continue;
+        }
+
+        successTestRunIds.push(testRunId);
+    }
+
+    return successTestRunIds;
+}
+```
diff --git a/docs/html-reporter/html-reporter-commands.mdx b/docs/html-reporter/html-reporter-commands.mdx
new file mode 100644
index 0000000..6acd392
--- /dev/null
+++ b/docs/html-reporter/html-reporter-commands.mdx
@@ -0,0 +1,111 @@
+# Команды плагина
+
+## Обзор {#overview}
+
+Плагин `html-reporter` добавляет к Testplane следующие команды:
+
+-   [gui](#gui) — чтобы запускать Testplane в GUI-режиме;
+-   [remove-unused-screens](#remove-unused-screens) — чтобы удалять неиспользуемые в тестах эталонные скриншоты;
+-   [merge-reports](#merge-reports) — чтобы объединять отдельные отчеты Testplane в один общий отчет.
+
+## gui
+
+Используйте команду `gui`, чтобы запустить Testplane в GUI-режиме.
+
+GUI-режим позволяет:
+
+-   интерактивно запускать тесты;
+-   переключать режимы работы с дампами прямо из отчета без перезапуска testplane;
+-   обновлять скриншоты — визуально отсматривая их и принимая только нужные диффы;
+-   переиспользовать отчеты из CI;
+-   фильтровать результаты прогона по ошибкам, ключам из меты, и пр.
+
+### Использование {#gui_usage}
+
+```bash
+npx testplane gui
+```
+
+## remove-unused-screens
+
+Используйте команду `remove-unused-screens`, чтобы удалить неиспользуемые в тестах эталонные скриншоты.
+
+### Как это работает?
+
+Сначала команда ищет скриншоты, для которых на файловой системе нет тестов.
+
+Далее команда ищет скриншоты, которые не были использованы в успешном тестировании (результат тестов берется из базы данных SQLite). Для этого html-отчет должен существовать на файловой системе и содержать результаты прогона тестов. Это означает, что вы должны до запуска команды `remove-unused-screens` запустить тесты локально или загрузить отчет из CI.
+
+### Использование {#remove_unused_screens_usage}
+
+Команда `remove-unused-screens` поддерживает несколько опций:
+
+<table>
+<thead>
+<tr><td>**Опция**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>-p, --pattern &lt;pattern></td><td>Шаблон для поиска скриншотов на файловой системе.</td></tr>
+<tr><td>--skip-questions</td><td>Не задавать вопросов во время выполнения (использовать значения по умолчанию).</td></tr>
+<tr><td>-h, --help</td><td>Вывести справочную информацию по команде в терминал.</td></tr>
+
+</tbody>
+</table>
+
+#### Примеры использования {#usage_examples}
+
+Указываем папку, в которой надо искать неиспользуемые скриншоты:
+
+```bash
+npx testplane remove-unused-screens -p 'testplane-screens-folder'
+```
+
+Задаем маску, по которой будем искать скриншоты:
+
+```bash
+npx testplane remove-unused-screens -p 'screens/**/*.png'
+```
+
+Задаем несколько масок для поиска скриншотов:
+
+```bash
+npx testplane remove-unused-screens -p 'screens/**/chrome/*.png' -p 'screens/**/firefox/*.png'
+```
+
+Задаем папку для поиска скриншотов и просим не задавать вопросов:
+
+```bash
+npx testplane remove-unused-screens -p 'testplane-screens-folder' --skip-questions
+```
+
+Выводим справочную информацию о команде:
+
+```bash
+npx testplane remove-unused-screens --help
+```
+
+## merge-reports
+
+Используйте команду `merge-reports`, чтобы объединить отдельные отчеты testplane в один общий отчет.
+
+Команда принимает пути к файлам баз данных или к файлам `databaseUrls.json` из других html-отчетов. Она создает новый html-отчет в папке назначения с общим файлом `databaseUrls.json`, который будет содержать ссылку на файл базы данных или на файлы `databaseUrls.json` из входных параметров. Файлы баз данных в папку назначения не копируются при этом.
+
+### Использование {#merge_reports_usage}
+
+Команда `merge-reports` поддерживает следующую обязательную опцию:
+
+<table>
+<thead>
+<tr><td>**Опция**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>-d, --destination &lt;folder></td><td>Путь к папке, в которую нужно сохранить итоговый отчет.</td></tr>
+
+</tbody>
+</table>
+
+Пример использования:
+
+```bash
+npx testplane merge-reports path-to-database.db path-to-databaseUrls.json -d dest-report
+```
diff --git a/docs/html-reporter/html-reporter-custom-gui.mdx b/docs/html-reporter/html-reporter-custom-gui.mdx
new file mode 100644
index 0000000..a2df10a
--- /dev/null
+++ b/docs/html-reporter/html-reporter-custom-gui.mdx
@@ -0,0 +1,112 @@
+import Admonition from "@theme/Admonition";
+
+# Кастомизация GUI
+
+## Обзор {#overview}
+
+<Admonition type="warning">
+Данный способ кастомизации GUI устарел.
+
+Вместо него рекомендуется использовать [плагины для отчета](./html-reporter-plugins).
+
+</Admonition>
+
+Используйте опцию `customGui` в конфиге плагина `html-reporter`, чтобы добавить собственные элементы управления для GUI-режима.
+
+Для элементов управления задается их тип (кнопка или радиокнопка), надписи и значения, а также функции инициализации и основного действия по нажатию. Элементы управления должны быть разбиты на отдельные разделы в зависимости от их назначения. Как минимум, должен быть указан один раздел.
+
+По умолчанию значение опции `customGui`: `{}`.
+
+## Настройка {#setup}
+
+Опция `customGui` требует для своего значения объект следующего формата:
+
+```javascript
+customGui: {
+    '&lt;название раздела>': [
+        {
+            type: '&lt;тип элементов управления>', // 'button' или 'radiobutton'
+            controls: [
+                {
+                    label: '&lt;надпись на элементе управления>',
+                    value: '&lt;значение элемента управления>'
+                },
+
+                // другие элементы управления...
+            ],
+            initialize: async ({ testplane, ctx }) => {
+                // код инициализации
+                // возвращаемое значение будет проигнорировано
+            },
+            action: async ({ testplane, ctx, control }) => {
+                // код действия
+                // возвращаемое значение будет проигнорировано
+            }
+        },
+
+        // другие группы элементов управления...
+    ],
+
+    // другие разделы...
+}
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Название**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>type</td><td>String</td><td>Обязательный параметр. Тип элементов управления. Доступные значения: _'button'_ и _'radiobutton'_.</td></tr>
+<tr><td>controls</td><td>Array</td><td>Массив объектов, каждый из которых описывает элемент управления. Объект должен состоять из двух ключей: _label_ и _value_, которые задают надпись на элементе управления и его значение.</td></tr>
+<tr><td>initialize</td><td>Function</td><td>Необязательный параметр. Асинхронная функция, которая будет выполнена на серверной стороне при старте Testplane в GUI-режиме. В функцию будет передан объект вида _\{ testplane, ctx }_, где _testplane_ — это инстанс testplane, а _ctx_ — объект, описывающий группу элементов, для которых вызывается функция инициализации.</td></tr>
+<tr><td>action</td><td>Function</td><td>Обязательный параметр. Асинхронная функция, которая будет выполнена на серверной стороне, когда пользователь нажмет на элемент управления. В функцию будет передан объект вида _\{ testplane, ctx, control }_, где _testplane_ — это инстанс testplane, _ctx_ — объект, описывающий группу элементов, для которых вызывается _action_-функция, и _control_ — ссылка на элемент управления, по которому кликнул пользователь.</td></tr>
+
+</tbody>
+</table>
+
+## Пример использования {#usage_example}
+
+Добавляем радиокнопки для изменения baseUrl'а в GUI-режиме:
+
+```javascript
+customGui: {
+    'some-meaningful-name-of-section': [
+        {
+            type: 'radiobutton',
+            controls: [
+                {
+                    label: 'Dev',
+                    value: 'http://localhost/development/'
+                },
+                {
+                    label: 'Prod',
+                    value: 'http://localhost/production/'
+                }
+            ],
+            initialize: async ({ testplane, ctx }) => {
+                const { config } = testplane;
+                const browserIds = config.getBrowserIds();
+
+                if (browserIds.length) {
+                    const { baseUrl } = config.forBrowser(browserIds[0]);
+
+                    ctx.controls.forEach((control) => {
+                        control.active = (baseUrl === control.value);
+                    });
+                }
+            },
+            action: async ({ testplane, ctx, control }) => {
+                const { config } = testplane;
+
+                config
+                    .getBrowserIds()
+                    .forEach((browserId) => {
+                        config.forBrowser(browserId).baseUrl = control.value;
+                    });
+            }
+        }
+    ]
+}
+```
diff --git a/docs/html-reporter/html-reporter-events.mdx b/docs/html-reporter/html-reporter-events.mdx
new file mode 100644
index 0000000..8fa4ab9
--- /dev/null
+++ b/docs/html-reporter/html-reporter-events.mdx
@@ -0,0 +1,124 @@
+# События плагина
+
+## Обзор {#overview}
+
+Плагин `html-reporter` добавляет в интерфейс Testplane специальный объект _htmlReporter_, через который, в том числе, можно подписаться на события отчета. Для этого `testplane.htmlReporter` предоставляет свойство `events` со списком событий, на которые можно подписаться:
+
+-   [DATABASE_CREATED](#database_created) — событие, которое триггерится сразу после создания sqlite базы данных;
+-   [TEST_SCREENSHOTS_SAVED](#test_screenshots_saved) — событие, которое триггерится после сохранения скриншотов теста;
+-   [REPORT_SAVED](#report_saved) — событие, которое триггерится после сохранения всех файлов отчета.
+
+## DATABASE_CREATED
+
+**sync | master**
+
+Событие `DATABASE_CREATED` триггерится сразу после создания sqlite базы данных. Обработчик события выполняется синхронно.
+
+### Подписка на событие {#database_created_subscription}
+
+```javascript
+testplane.htmlReporter.on(testplane.htmlReporter.events.DATABASE_CREATED, db => {
+    console.info(`Выполняется обработка события DATABASE_CREATED...`);
+});
+```
+
+#### Параметры обработчика {#database_created_handler_params}
+
+В обработчик события передается инстанс базы данных.
+
+### Пример использования {#database_created_example}
+
+```javascript
+const parseConfig = require("./config");
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled || testplane.isWorker()) {
+        // или плагин отключен, или мы находимся в контексте воркера – уходим
+        return;
+    }
+
+    // свойство "htmlreporter" гарантированно есть в объекте "testplane"
+    // в момент срабатывания события INIT
+    testplane.on(testplane.events.INIT, () => {
+        testplane.htmlReporter.on(testplane.htmlReporter.events.DATABASE_CREATED, db => {
+            db.prepare(`CREATE TABLE IF NOT EXISTS testTable (foo TEXT, bar TEXT)`).run();
+        });
+    });
+};
+```
+
+## TEST_SCREENSHOTS_SAVED
+
+**async | master**
+
+Событие `TEST_SCREENSHOTS_SAVED` триггерится после сохранения скриншотов очередного теста. Обработчик события может быть асинхронным.
+
+### Подписка на событие {#test_screenshots_saved_subscription}
+
+```javascript
+testplane.htmlReporter.on(
+    testplane.htmlReporter.events.TEST_SCREENSHOTS_SAVED,
+    async ({ testId, attempt, imagesInfo }) => {
+        console.info(
+            `Screenshots for test "${testId}" (attempt #${attempt}) were saved:`,
+            imagesInfo,
+        );
+
+        /* Expected output:
+        Screenshots for test "Feature Test.chrome-desktop" (attempt #0) were saved:
+        [
+            {
+                stateName: 'plain',
+                refImg: { path: '...', size: { width: 400, height: 200 } },
+                status: 'fail',
+                error: undefined,
+                diffClusters: [...],
+                expectedImg: { path: '...', size: { width: 400, height: 200 } }
+                actualImg: { path: '...', size: { width: 400, height: 200 } }
+                diffImg: { path: '...', size: { width: 400, height: 200 } }
+            }
+        ]
+        */
+    },
+);
+```
+
+#### Параметры обработчика {#test_screenshots_saved_handler_params}
+
+В обработчик события передается объект с информацией о тесте следующего вида:
+
+```javascript
+{
+    testId, // идентификатор теста вида "<test full title>.<browser id>"
+        attempt, // номер попытки выполнения теста
+        imagesInfo; // информация о скриншотах (см. выше пример подписки на событие)
+}
+```
+
+## REPORT_SAVED
+
+**async | master**
+
+Событие `REPORT_SAVED` триггерится после сохранения всех файлов отчета. Обработчик события может быть асинхронным.
+
+### Подписка на событие {#report_saved_subscription}
+
+```javascript
+testplane.htmlReporter.on(testplane.htmlReporter.events.REPORT_SAVED, async ({ reportPath }) => {
+    console.info(`Выполняется обработка события REPORT_SAVED, report path = ${reportPath}...`);
+});
+```
+
+#### Параметры обработчика {#report_saved_handler_params}
+
+В обработчик передается объект с ключом `reportPath`, в значении которого хранится путь к сохраненному отчету.
+
+### Пример использования {#report_saved_example}
+
+```javascript
+testplane.htmlReporter.on(testplane.htmlReporter.events.REPORT_SAVED, async ({ reportPath }) => {
+    await uploadDirToS3(reportPath); // загружаем отчет в хранилище S3
+});
+```
diff --git a/docs/html-reporter/html-reporter-plugins.mdx b/docs/html-reporter/html-reporter-plugins.mdx
new file mode 100644
index 0000000..157da98
--- /dev/null
+++ b/docs/html-reporter/html-reporter-plugins.mdx
@@ -0,0 +1,301 @@
+# Плагины для отчета
+
+## Обзор {#overview}
+
+Используйте опцию `plugins` в конфиге плагина `html-reporter`, чтобы расширить функциональность отчета с помощью собственных плагинов к отчету.
+
+Чтобы ваши плагины в отчете заработали, включите опцию [pluginsEnabled][plugins-enabled] в конфиге плагина `html-reporter`, установив её значение в `true`.
+
+Список плагинов задается в виде массива с их описаниями. По умолчанию список считается пустым: `[]`.
+
+Плагины позволяют добавить в отчет собственные UI-компоненты (как для статического отчета, так и для GUI-режима), а также серверные «ручки» _(routes)_ (для GUI-режима).
+
+## Настройка {#setup}
+
+Описание плагинов выглядит следующим образом:
+
+```javascript
+plugins: [
+    {
+        name: "plugin-name",
+        component: "PluginReactComponentName",
+        point: "extension-point-name",
+        position: "wrap",
+        config: { param: "value" },
+    },
+    {
+        name: "plugin-name",
+        component: "AnotherPluginReactComponentName",
+        point: "extension-point-name",
+        position: "before",
+    },
+
+    // ...
+];
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[name](#name)</td><td>String</td><td>Обязательный параметр. Имя пакета с плагином для отчета. Предполагается, что плагин можно будет подключить с помощью _require(name)_.</td></tr>
+<tr><td>[component](#component)</td><td>String</td><td>Имя React-компонента из плагина.</td></tr>
+<tr><td>[point](#point)</td><td>String</td><td>Имя точки расширения в плагине _html-reporter_.</td></tr>
+<tr><td>[position](#position)</td><td>String</td><td>Определяет способ, с помощью которого компонент будет размещен в точке расширения.</td></tr>
+<tr><td>[config](#config)</td><td>Object</td><td>Конфигурация плагина.</td></tr>
+
+</tbody>
+</table>
+
+Плагин, для которого задан только параметр `name`, может быть использован для переопределения существующей мидлвари GUI-сервера.
+
+Плагин может определять больше одного компонента. Каждый компонент может быть применен к нескольким точкам расширения и/или несколько раз к одной и той же точке (с отдельными конфигурационными записями). Порядок применения компонентов определяется порядком конфигурации.
+
+### name
+
+Обязательный параметр. Имя пакета с плагином для отчета. Предполагается, что плагин можно будет подключить с помощью _require(name)_.
+
+### component
+
+Имя React-компонента из плагина.
+
+### point
+
+Имя точки расширения в плагине _html-reporter_.
+
+Определяет конкретное месторасположение указанного компонента внутри пользовательского интерфейса html-отчета.
+
+Подробнее смотрите в разделе «Точки расширения».
+
+### position
+
+Определяет способ, с помощью которого компонент будет размещен в точке расширения пользовательского интерфейса html-отчета.
+
+Доступны следующие значение:
+
+<table>
+<thead>
+<tr><td>**Значение**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>wrap</td><td>обернуть точку расширения в UI</td></tr>
+<tr><td>before</td><td>разместить компонент перед точкой расширения</td></tr>
+<tr><td>after</td><td>разместить компонент после точки расширения</td></tr>
+
+</tbody>
+</table>
+
+### config
+
+Конфигурация плагина.
+
+## Код плагинов для отчета {#plugins_code}
+
+Примеры плагинов можно [посмотреть в функциональных тестах][html-reporter-plugins].
+
+Плагин `html-reporter` — это объект с некоторым набором React-компонентов, заданных в виде его ключей, и необязательным ключом `reducers` с массивом redux-редьюсеров для управления состоянием компонентов, которые позже объединяются с помощью [reduce-reducers][reduce-reducers].
+
+Ожидается, что плагин для отчета будет иметь следующие модульные файлы в корне своего пакета: `plugin.js` и/или `middleware.js`.
+
+### plugin.js
+
+Опциональный модуль. Файл, который должен экспортировать объект (или набор именованных экспортов) или функцию, возвращающую такой объект или массив с некоторой определенной структурой.
+
+Можно повторно использовать зависимости `html-reporter` в плагинах (React, Redux и др.). Для этого из модуля должен быть экспортирован массив со списком необходимых зависимостей, за которым следует функция, с переданными ей соответствующими зависимостями, и возвращающая сам плагин.
+
+Например:
+
+```javascript
+import "plugin-styles.css";
+
+export default [
+    "react",
+    function (React, options) {
+        class PluginComponent extends React.Component {
+            // реализация компонента
+        }
+
+        return {
+            PluginComponent,
+            reducers: [],
+        };
+    },
+];
+```
+
+Стили для плагина должны загружаться вместе с `plugin.js`, и итоговый файл должен быть одним бандлом.
+
+Значение, экспортируемое из `plugin.js`, должно передаваться в `__testplane_html_reporter_register_plugin__`.
+
+Это можно сделать двумя способами.
+
+Например, настроить сборку _webpack_ так, чтобы она создавала соответствующую библиотеку `jsonp`:
+
+```javascript
+// ...
+output: {
+    filename: 'plugin.js',
+    path: __dirname,
+    library: '__testplane_html_reporter_register_plugin__',
+    libraryTarget: 'jsonp'
+},
+// ...
+```
+
+Или передать значение, экспортируемое из `plugin.js`, явно:
+
+```javascript
+__testplane_html_reporter_register_plugin__([
+    "react",
+    function (React, options) {
+        // ...
+        return { PluginComponent };
+    },
+]);
+```
+
+### middleware.js
+
+Опциональный модуль. Экспортирует функцию, принимающую `Router` от [express][express]. Ожидается, что «ручки» плагина будут подключены к роутеру. А роутер затем подключается к «ручке» `/plugin-routes/:pluginName/`.
+
+```javascript
+module.exports = function (pluginRouter) {
+    pluginRouter.get("/plugin-route", function (req, res) {
+        // реализация «ручки»
+    });
+};
+```
+
+Затем «ручки» могут быть вызваны из React-компонентов плагина, определенных в `plugin.js `. Для удобства имя плагина всегда передается с опциями под названием `pluginName`, когда для экспорта используется функция или массив функций:
+
+```javascript
+export default ['react', 'axios', function(React, axios, { pluginName, pluginConfig, actions, actionNames, selectors }) {
+    class PluginComponent extends React.Component {
+        // ... где-то внутри компонента ...
+        const result = await axios.get(`/plugin-routes/${pluginName}/plugin-route`);
+    }
+
+    return {
+        PluginComponent,
+        reducers: []
+    };
+}
+```
+
+В этом примере также можно увидеть следующие свойства:
+
+<table>
+<thead>
+<tr><td>**Свойство**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>pluginName</td><td>имя плагина</td></tr>
+<tr><td>pluginConfig</td><td>конфигурация плагина</td></tr>
+<tr><td>actions</td><td>Redux-действия</td></tr>
+<tr><td>actionNames</td><td>имена действий в _html-reporter_, которые используются в Redux-действиях, чтобы иметь возможность подписаться на события отчета</td></tr>
+<tr><td>selectors</td><td>закэшированные селекторы отчета, которые были созданы с помощью библиотеки [reselect][redux-reselect]</td></tr>
+
+</tbody>
+</table>
+
+### Доступные зависимости {#available_deps}
+
+В плагинах доступны следующие зависимости:
+
+-   [react][react]
+-   [redux][redux]
+-   [react-redux][react-redux]
+-   [lodash][lodash]
+-   [prop-types][prop-types]
+-   [classnames][classnames]
+-   [semantic-ui-react][semantic-ui-react]
+-   [react-markdown][react-markdown]
+-   [reduce-reducers][reduce-reducers]
+-   [immer][immer]
+-   [reselect][redux-reselect]
+-   [axios][axios]
+
+### Доступные компоненты {#available_components}
+
+#### `<Details />`
+
+Компонент, с помощью которого можно переключать отображение контента (аналог ката).
+
+Пример использования:
+
+```javascript
+// ...внутри вашего React-компонента
+
+render() {
+    return <Details
+        title='Some title'
+        content='Some content' // контент, который будет появляться по нажатию на заголовок
+        extendClassNames='some_class_name' // можно добавить свои css-классы к компоненту
+        onClick={() => console.log('clicked')} // а также свой обработчик
+    />
+}
+```
+
+где:
+
+<table>
+<thead>
+<tr><td>**Свойство**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>title</td><td>String или JSX.Element</td><td>Обязательный параметр. Заголовок, описывающий информацию, скрытую под ним.</td></tr>
+<tr><td>content</td><td>Function или String или String[] или JSX.Element</td><td>Обязательный параметр. Контент, который будет появляться по нажатию на заголовок.</td></tr>
+<tr><td>extendClassNames</td><td>String или String[]</td><td>Css-классы, которые нужно добавить к компоненту. Необязательный параметр.</td></tr>
+<tr><td>onClick</td><td>Function</td><td>Обработчик, который будет вызван по нажатию на заголовок. Необязательный параметр.</td></tr>
+
+</tbody>
+</table>
+
+## Точки расширения {#extension_points}
+
+Точки расширения — это места в пользовательском интерфейсе отчета, которые доступны для расширения с помощью React-компонентов, экспортируемых _плагинами для отчета_.
+
+Каждая точка расширения может передавать определенные props'ы компонентам плагина в зависимости от самой точки. Поскольку некоторые плагины могут полагаться на конкретное размещение и, следовательно, на конкретные props'ы, то можно ограничить компоненты плагина определенными точками расширения, указав статическое свойство `point` для таких компонентов плагина:
+
+```javascript
+class PluginComponent extends React.Component {
+    static point = "result";
+    // ...
+}
+```
+
+В данный момент доступны следующие точки расширения:
+
+<table>
+<thead>
+<tr><td>**Точка**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>result</td><td>Позволяет расширить каждый результат теста. Добавляет props'ы _resultId_ и _testName_ в компонент плагина.</td></tr>
+<tr><td>result_meta</td><td>Позволяет расширить мета-информацию для каждого результата теста. Добавляет props'ы _resultId_ и _testName_ в компонент плагина.</td></tr>
+<tr><td>menu-bar</td><td>Позволяет расширить меню.</td></tr>
+<tr><td>root</td><td>Позволяет добавить такие плавающие элементы, как модальное окно или попап.</td></tr>
+
+</tbody>
+</table>
+
+Точка расширения может быть расширена более чем одним компонентом. В этом случае порядок применения компонентов определяется порядком настройки плагинов. Каждый следующий компонент применяется ко всем ранее составленным компонентам в точке расширения.
+
+[plugins-enabled]: ./html-reporter-setup#pluginsenabled
+[html-reporter-plugins]: https://github.com/gemini-testing/html-reporter/blob/master/test/func/fixtures/plugins
+[reduce-reducers]: https://github.com/redux-utilities/reduce-reducers
+[express]: https://github.com/expressjs/express
+[redux-reselect]: https://github.com/reduxjs/reselect
+[react]: https://github.com/facebook/react
+[redux]: https://github.com/reduxjs/redux
+[react-redux]: https://github.com/reduxjs/react-redux
+[lodash]: https://github.com/lodash/lodash
+[prop-types]: https://github.com/facebook/prop-types
+[classnames]: https://github.com/JedWatson/classnames
+[semantic-ui-react]: https://github.com/Semantic-Org/Semantic-UI-React
+[react-markdown]: https://github.com/remarkjs/react-markdown
+[immer]: https://github.com/immerjs/immer
+[axios]: https://github.com/axios/axios
diff --git a/docs/html-reporter/html-reporter-setup.mdx b/docs/html-reporter/html-reporter-setup.mdx
new file mode 100644
index 0000000..3ae56dc
--- /dev/null
+++ b/docs/html-reporter/html-reporter-setup.mdx
@@ -0,0 +1,423 @@
+---
+sidebar_class_name: hidden
+---
+
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+import Admonition from "@theme/Admonition";
+
+# Подключение html-reporter
+
+## Обзор {#overview}
+
+Используйте плагин [html-reporter][html-reporter], чтобы получить html-отчет о прогоне тестов.
+
+![Html-отчет](/img/docs/html-reporter/html-reporter.overview.png)
+
+<Admonition type="warning" title="Требования к testplane">
+    Для корректной работы плагина _html-reporter_ требуется [testplane][testplane] версии 4 и выше.
+</Admonition>
+
+Плагин сохраняет результаты прогона тестов в базу данных [SQLite][sqlite]. Поэтому вы не сможете открыть локальный отчет как файл с помощью `file://` протокола.
+
+Чтобы посмотреть отчет, запустите testplane в GUI-режиме:
+
+```bash
+npx testplane gui
+```
+
+Или запустите [http-server][http-server] в папке с отчетом:
+
+```bash
+npx http-server -p 8000
+```
+
+Если вы запускаете локальный сервер не из папки с отчетом, то укажите путь к отчету:
+
+```bash
+npx http-server ./testplane-report -p 8000
+```
+
+После чего откройте страницу `http://localhost:8000` в браузере.
+
+## Установка {#install}
+
+```bash
+npm install -D html-reporter
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+<Tabs>
+<TabItem value="Минимальный конфиг" label="Минимальный конфиг">
+```javascript
+    module.exports = {
+        plugins: {
+            'html-reporter/testplane': {
+                enabled: true
+            },
+
+            // другие плагины testplane...
+        },
+
+        // другие настройки testplane...
+    };
+    ```
+
+</TabItem>
+
+<TabItem value="Максимальный конфиг" label="Максимальный конфиг">
+```javascript
+    module.exports = {
+        plugins: {
+            'html-reporter/testplane': {
+                enabled: true,
+                path: 'my/testplane-reports',
+                defaultView: 'all',
+                baseHost: 'test.com',
+                errorPatterns: [
+                    'Parameter .* must be a string',
+                    {
+                        name: 'Cannot read property of undefined',
+                        pattern: 'Cannot read property .* of undefined',
+                        hint: '<div>google it, i dont know how to fix it =(</div>'
+                    }
+                ],
+                customScripts: [
+                    function() {
+                        // кастомный скрипт
+                    },
+
+                    // другие скрипты...
+                ],
+                customGui: {
+                    // DEPRECATED (этот параметр устарел)
+                    // дополнительные элементы управления для GUI-режима
+                    // используйте plugins (плагины для отчета) вместо customGui
+                },
+                pluginsEnabled: true,
+                plugins: [
+                    // плагины для отчета...
+                ],
+                yandexMetrika: {
+                    counter: 1234567
+                }
+            },
+
+            // другие плагины testplane...
+        },
+
+        // другие настройки testplane...
+    }
+    ```
+
+</TabItem>
+
+</Tabs>
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[enabled](#enabled)</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>[path](#path)</td><td>String</td><td>"testplane-report"</td><td>Путь к папке для сохранения файлов html-отчета.</td></tr>
+<tr><td>[saveErrorDetails](#saveerrordetails)</td><td>Boolean</td><td>false</td><td>Сохранять / не сохранять подробности ошибок в json-файлах.</td></tr>
+<tr><td>[defaultView](#defaultview)</td><td>String</td><td>"all"</td><td>Режим фильтрации тестов при отображении, который будет установлен по умолчанию.</td></tr>
+<tr><td>[diffMode](#diffmode)</td><td>String</td><td>"3-up"</td><td>Режим просмотра диффов, который будет установлен по умолчанию.</td></tr>
+<tr><td>[baseHost](#basehost)</td><td>String</td><td>_N/A_</td><td>Заменяет оригинальный адрес хоста для просмотра в браузере.</td></tr>
+<tr><td>[errorPatterns](#errorpatterns)</td><td>Object[] или String[]</td><td>[ ]</td><td>Паттерны ошибок с подсказками для улучшения UX отчета.</td></tr>
+<tr><td>[metaInfoBaseUrls](#metainfobaseurls)</td><td>Object</td><td>`{ }`</td><td>Базовые URL-адреса для формирования ссылок в разделе _Meta_ на основе мета-информации о прогоне теста.</td></tr>
+<tr><td>[saveFormat](#saveformat)</td><td>String</td><td>"sqlite"</td><td>ПАРАМЕТР УСТАРЕЛ. Позволяет задать формат, в котором будут сохранены результаты прогона тестов.</td></tr>
+<tr><td>[customGui](#customgui)</td><td>Object</td><td>`{ }`</td><td>ПАРАМЕТР УСТАРЕЛ. Используйте вместо него [plugins](#plugins). Описание собственных элементов управления для GUI-режима.</td></tr>
+<tr><td>[pluginsEnabled](#pluginsenabled)</td><td>Boolean</td><td>false</td><td>Включить плагины для отчета.</td></tr>
+<tr><td>[plugins](#plugins)</td><td>Object[]</td><td>[ ]</td><td>Список плагинов с их настройками.</td></tr>
+<tr><td>[customScripts](#customscripts)</td><td>Function[]</td><td>[ ]</td><td>Список функций, реализующих кастомные скрипты. Например, скрипты Яндекс.Метрики или Жучка.</td></tr>
+<tr><td>[yandexMetrika](#yandexmetrika)</td><td>Object</td><td>`{ }`</td><td>[Яндекс.Метрика][yandex-metrika].</td></tr>
+
+</tbody>
+</table>
+
+### enabled
+
+Включает или отключает плагин.
+
+### path
+
+Путь к папке для сохранения файлов html-отчета. По умолчанию файлы будут сохранены в папку `testplane-report` в текущей рабочей папке.
+
+### saveErrorDetails
+
+Сохранять или не сохранять подробности ошибок в json-файлах (в папку `error-details`).
+
+По умолчанию «не сохранять»: `false`.
+
+Любой плагин testplane может добавить какие-либо подробности в объект ошибки при её возникновении. Эти подробности могут помочь пользователю в отладке проблем, которые возникли в тесте. Html-reporter сохраняет эти детали в папке `error-details` в файле с именем: `&lt;хэш от полного названия теста>-&lt;браузер>_&lt;номер ретрая>_&lt;временная метка>.json`.
+
+Под стектрейсом html-reporter добавляет раздел `Error details` со ссылкой `<title>`, указывающей на json-файл. Пользователь может открыть этот файл либо в браузере, либо в любой IDE.
+
+Пример как добавить подробности в объект ошибки из плагина:
+
+```javascript
+const err = new Error("some error");
+
+err.details = {
+    title: "description, will be used as url title",
+    data: {}, // или [], или String
+};
+
+throw err;
+```
+
+### defaultView
+
+Режим фильтрации тестов при отображении, который будет установлен по умолчанию. Доступны следующие значения:
+
+<table>
+<thead>
+<tr><td>**Режим**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>all</td><td>все тесты</td></tr>
+<tr><td>passed</td><td>только успешные тесты</td></tr>
+<tr><td>failed</td><td>только упавшие тесты</td></tr>
+<tr><td>retried</td><td>только те тесты, в которых были ретраи (повторные запуски)</td></tr>
+<tr><td>skipped</td><td>только отключенные (заскипанные) тесты</td></tr>
+
+</tbody>
+</table>
+
+По умолчанию: `all`, то есть если параметр не задан, то будут показываться все тесты.
+
+### diffMode
+
+Режим просмотра диффов, который будет установлен по умолчанию. Доступны следующие значения:
+
+<table>
+<thead>
+<tr><td>**Режим**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>3-up</td><td>все изображения _(expected, actual, diff)_ в одном столбце, друг под другом</td></tr>
+<tr><td>3&#8209;up&#8209;scaled</td><td>все изображения _(expected, actual, diff)_ в один ряд так, чтобы они помещались на экране</td></tr>
+<tr><td>only-diff</td><td>только дифф _(diff)_</td></tr>
+<tr><td>switch</td><td>эталонное изображение с возможностью переключаться на актуальное изображение по клику мыши</td></tr>
+<tr><td>swipe</td><td>актуальное изображение поверх эталонного, с разделителем открывающим эталонное изображение</td></tr>
+<tr><td>onion-skin</td><td>актуальное изображение поверх эталонного с возможностью менять прозрачность актуального изображения</td></tr>
+
+</tbody>
+</table>
+
+По умолчанию: `3-up`.
+
+### baseHost
+
+Заменяет оригинальный адрес хоста для просмотра в браузере. По умолчанию оригинальный адрес хоста не изменяется.
+
+### errorPatterns
+
+Паттерны ошибок используются:
+
+-   чтобы показать более понятную информацию об ошибках, если они соответствуют паттернам, для которых есть подробное описание;
+-   в режиме отображения `Group by` с выбранным ключом `error`.
+
+Паттерны ошибок можно задавать как в виде объектов, так и в виде строк.
+
+Чтобы задать паттерн ошибки в виде объекта, используйте следующий формат:
+
+```javascript
+{
+    name: '&lt;название ошибки>',
+    pattern: '&lt;паттерн ошибки>',
+    hint: '&lt;подсказка пользователю>'
+}
+```
+
+где:
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>name</td><td>String</td><td>Название ошибки.</td></tr>
+<tr><td>pattern</td><td>String или RegExp</td><td>Регулярное выражение или обычная строка, которой должна соответствовать ошибка.</td></tr>
+<tr><td>hint</td><td>String</td><td>Необязательный параметр. Подсказка, что можно сделать с данной ошибкой: почему она возникла, как её исправить и т. п.</td></tr>
+
+</tbody>
+</table>
+
+Если паттерн ошибки задан в виде строки, например: `&lt;ошибка>`, то эта строка автоматически рассматривается как объект вида:
+
+```javascript
+{
+    name: '&lt;ошибка>',
+    pattern: '&lt;ошибка>'
+}
+```
+
+Такой способ задания паттерна удобен для тех ошибок, у которых `name` и `pattern` полностью совпадают.
+
+Когда один из шаблонов ошибок совпадает с сообщением об ошибке, то:
+
+-   `name` шаблона ошибки будет отображаться как заголовок сообщения об ошибке, а исходное сообщение об ошибке будет скрыто под катом;
+-   `hint` для ошибки будет отображаться после поля ошибки `stack`. Подсказка может быть задана в виде html-строки. Например, `<div>some-useful-hint</div>`.
+
+В режиме `Group by` _(группировать по)_ с выбранным ключом `error` тест будет связан с группой, если ошибка теста совпадает с шаблоном ошибок группы. Если тест не может быть связан с существующими группами, то будет создана новая группа.
+
+### metaInfoBaseUrls
+
+Базовые URL-адреса для формирования ссылок в разделе `Meta` на основе мета-информации о прогоне теста.
+
+Параметр задается в виде объекта:
+
+```javascript
+{
+    '&lt;опция-1>': 'значение опции 1',
+    '&lt;опция-2>': 'значение опции 2',
+    // и т. д.
+}
+```
+
+Например:
+
+```javascript
+{
+    'file': 'base/path'
+}
+```
+
+### saveFormat
+
+**Параметр устарел**
+
+Позволяет задать формат, в котором будут сохранены результаты прогона тестов.
+
+Доступным осталось только одно значение, которое используется по умолчанию:
+
+-   `sqlite` — сохранить результаты прогона тестов в базе данных формата SQLite.
+
+### customGui
+
+**Параметр устарел**
+
+<Admonition type="warning">
+    Вместо _customGui_ рекомендуется использовать [плагины для отчета](#plugins).
+</Admonition>
+
+Описание собственных элементов управления для GUI-режима.
+
+Смотрите подробнее в разделе «[Кастомизация GUI](./html-reporter-custom-gui)».
+
+### pluginsEnabled
+
+Включить плагины для `html-reporter`.
+
+### plugins
+
+Список плагинов с их настройками.
+
+Смотрите подробнее в разделе «[Плагины для отчета](./html-reporter-plugins)».
+
+### customScripts
+
+Список кастомных скриптов в виде массива функций. С помощью этого параметра можно добавить любой скрипт на страницу html-отчета. Например, для сбора каких-либо метрик или реализации дополнительной функциональности. Скрипты будут выполнены сразу после рендеринга страницы.
+
+Пример:
+
+```javascript
+customScripts: [
+    function () {
+        console.info("some logs");
+    },
+    () => {
+        const div = document.createElement("div");
+        div.innerHTML = "hello";
+        document.body.prepend(div);
+    },
+];
+```
+
+### yandexMetrika
+
+Данный параметр позволяет добавить в отчет [Яндекс.Метрику][yandex-metrika]. Параметр задается в виде объекта с ключом `counterNumber` _(номер счетчика)_. В качестве значения ключа необходимо указать номер счетчика Яндекс.Метрики (см. «[Как создать счетчик][how-to-create-counter]»). Номер должен задаваться как число _(Number)_, а не строка.
+
+Также в интерфейсе Яндекс.Метрики необходимо перейти в разделе настроек на вкладку _«Счетчик»_, нажать кнопку _«Скопировать»_ и вставить код счетчика в поле [customScripts](#customscripts).
+
+С помощью метрики вы сможете узнать как разработчики взаимодействуют с вашим отчетом и с какого рода проблемами они сталкиваются.
+
+Отчет поддерживает следующие [цели для метрики][yandex-metrika-goals]:
+
+-   **ACCEPT_SCREENSHOT** — было нажатие на кнопку _Accept_ для принятия скриншота;
+-   **ACCEPT_OPENED_SCREENSHOTS** — было нажатие на кнопку _Accept opened_ для принятия скриншотов из открытых тестов.
+
+Пример настройки _Яндекс.Метрики_ в одном из проектов:
+
+```javascript
+module.exports = {
+    plugins: {
+        'html-reporter/testplane': {
+            customScripts: [
+                function(){(function(m,e,t,r,i,k,a){m[i]=m[i]<tr><td>function(){(m[i].a=m[i].a</td></tr>[]).push(arguments)}; m[i].l=1*new Date();k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)}) (window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym"); ym(56782912, "init", { clickmap:true, trackLinks:true, accurateTrackBounce:true, webvisor:true })},
+
+                // другие скрипты...
+            ],
+            yandexMetrika: {
+                counterNumber: 1234567
+            },
+
+            // другие настройки плагина...
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+### Передача параметров через CLI {#setup_by_cli}
+
+Все параметры плагина, которые можно определить в конфиге, можно также передать в виде опций командной строки или через переменные окружения во время запуска testplane. Используйте префикс `--html-reporter-` для опций командной строки и `html_reporter_` — для переменных окружения.
+
+Например, параметр настроек [path](#path) можно передать следующими способами:
+
+```bash
+testplane path/to/mytest.js --html-reporter-path custom/dir
+```
+
+```bash
+html_reporter_path=custom/dir testplane path/to/mytest.js
+```
+
+## Хранение данных {#data_storage}
+
+Как уже было сказано выше, `html-reporter` сохраняет результаты прогона тестов в базу данных [SQLite][sqlite].
+
+Почему мы используем SQLite? Потому что он:
+
+-   бессерверный, легко подключаемый и не требует настроек
+-   кросс-платформенный, запускается на любой операционной системе
+-   одно-файловый, легко переиспользовать отчеты и делиться ими
+-   быстрее, чем если хранить отчет на файловой системе
+-   компактный и имеет полноценный SQL.
+
+Файлы, который создаются во время выполнения тестов:
+
+-   `sqlite.db` — база данных Sqlite с результатами прогона тестов
+-   `data.js` — конфиг отчета
+-   `databaseUrls.json` — абсолютные или относительные URL-адреса на базы данных SQLite (`sqlite.db`) и/или URL-адреса других файлов `databaseUrls.json` (см. команду [merge-reports][merge-reports])
+
+[html-reporter]: https://github.com/gemini-testing/html-reporter
+[testplane]: https://github.com/gemini-testing/testplane
+[sqlite]: https://www.sqlite.org/index.html
+[yandex-metrika]: https://yandex.ru/support/metrica/index.html
+[yandex-metrika-goals]: https://yandex.ru/support/metrica/general/goals.html
+[how-to-create-counter]: https://yandex.ru/support/metrica/general/creating-counter.html
+[merge-reports]: ./html-reporter-commands#merge-reports
+[http-server]: https://github.com/http-party/http-server#http-server-a-simple-static-http-server
diff --git a/docs/index.mdx b/docs/index.mdx
new file mode 100644
index 0000000..40f5d03
--- /dev/null
+++ b/docs/index.mdx
@@ -0,0 +1,124 @@
+# Обзор
+
+## О Testplane
+
+**Testplane** — это инструмент для автоматизации тестирования пользовательских сценариев в web-интерфейсах.
+
+С помощью неё вы можете протестировать функциональность своего сайта или проекта, а также проверить, что ваша верстка при любых обстоятельствах соответствует эталонной. В вашем распоряжении — весь [спектр команд][commands], которые предоставляет [WebDriverIO v8][webdriverio-api], и [все возможности протокола Chrome DevTools][how-to-use-cdp]. А ещё — привычный синтаксис [Mocha][mocha].
+
+В вашем проекте становится всё больше и больше тестов? — Testplane позволит вам легко масштабировать их прогон, не теряя в юзабилити. Она умеет не только запускать тесты параллельно, в разных браузерах, на разных платформах, но и собирать все результаты прогонов в единый html-отчет, с возможностями гибкого просмотра, группировки и фильтрации тестов.
+
+Вам не хватает какой-то функциональности? — Не проблема! Вы можете написать свой плагин и решить свою задачу с максимальной эффективностью. Или найти уже готовый плагин и добавить его к своему проекту.
+
+И это не всё.
+
+## Почему именно Testplane? {#why-testplane}
+
+-   [Легкая настройка и большие возможности](#easystart_great_features)
+-   [Быстрое выполнение тестов](#fast)
+-   [Гибкий запуск тестов](#flexible)
+-   [Умное поведение при ошибках](#smart)
+-   [Подробный отчет о прогоне тестов](#user_friendly)
+-   [Интерактивный запуск тестов](#interactive)
+-   [Богатые возможности для отладки](#debuggable)
+-   [Расширяемость](#extendable)
+
+### Легкая настройка и большие возможности {#easystart_great_features}
+
+-   быстрое создание проекта с помощью [create-testplane][create-testplane];
+-   все ключевые параметры имеют [оптимальные дефолты][defaults];
+-   легко писать тесты, так как в основе [Mocha][mocha];
+-   большой [спектр команд][commands], «под капотом» — [WebdriverIO v8][webdriverio-api];
+-   своя мощная команда [assertView][assert-view] для снятия и сравнения скриншотов;
+-   при сравнении скриншотов [можно гибко управлять параметрами][assert-view-opts] для отдельных тестов;
+-   при снятии скриншотов можно указать какие области игнорировать;
+-   автоматическая склейка больших изображений, выходящих за пределы вьюпорта.
+
+### Быстрое выполнение тестов {#fast}
+
+-   за счет [параллельности внутри Testplane][testplane-workers];
+-   масштабирование с помощью [testplane-chunks][testplane-chunks];
+-   [повторное реиспользование сессий][sessions-reuse];
+-   кэширование сессий с браузерами;
+-   20000 тестов за 10 минут — легко!
+
+### Гибкий запуск тестов {#flexible}
+
+-   в конкретном браузере;
+-   [по платформам (sets)][testplane-sets] — на десктопных и мобильных браузерах;
+-   [по совпадению с маской][testplane-option-grep];
+-   [из конкретного файла][how-to-run-test-in-file];
+-   [заданное количество раз для проверки стабильности][how-to-check-test-stability];
+-   [хелперы only.in, only.notIn, skip.in, skip.notIn][how-to-skip-tests].
+
+### Умное поведение при ошибках {#smart}
+
+-   [отказ от сессий, упавших с заданными паттернами ошибок][patterns-on-reject];
+-   [ретраи с ограничением по времени и количеству ретраев][retry-limiter];
+-   [ретраи инфраструктурных ошибок][retry-progressive].
+
+### Подробный отчет о прогоне тестов {#user_friendly}
+
+-   способен отображать [результаты прогона десятков тысяч тестов одновременно][html-reporter];
+-   не тормозит при любых объемах;
+-   предоставляет полную информацию о прогоне тестов: ретраи, мета-информация, скриншоты, логи и т. д.;
+-   дифф в скриншотах [можно смотреть в 6 режимах][html-reporter-diff], включая _switch, swipe_ и _onion skin;_
+-   доступна история выполненных команд в тесте;
+-   в случае падения теста сохраняется сообщение об ошибке и её стектрейс;
+-   [гибкие возможности просмотра, группировки и фильтрации тестов][html-reporter-gui].
+
+### Интерактивный запуск тестов {#interactive}
+
+-   запуск тестов прямо из отчета в [режиме GUI][html-reporter-gui];
+-   доступны все возможности отчета, перечисленные в разделе выше;
+-   [возможность интеграции дополнительных элементов управления][html-reporter-plugins] для режима GUI из других плагинов;
+-   обновление скриншотов в ускоренном режиме;
+
+### Богатые возможности для отладки {#debuggable}
+
+-   [DevTools в CDP-режиме][how-to-use-cdp];
+-   [профайлинг Testplane][testplane-profiler];
+-   [профайлинг плагинов][testplane-plugins-profiler].
+
+### Расширяемость {#extendable}
+
+-   [легко добавить свои собственные команды][prepare-browser];
+-   в наличии [десятки готовых плагинов][plugins];
+-   можно написать свой плагин для реализации любой функциональности;
+-   [свыше 20 событий, на которые можно подписаться][testplane-events];
+-   доступны [точки расширения][html-reporter-extension-points] в отчете testplane;
+-   можно [расширять CLI Testplane из своего плагина][testplane-cli], добавляя новые команды и опции.
+
+[create-testplane]: https://github.com/gemini-testing/create-testplane
+[webdriverio-api]: https://webdriver.io/docs/api
+[mocha]: https://mochajs.org
+[testplane-chunks]: ./plugins/testplane-chunks
+[testplane-option-grep]: ./guides/how-to-run-specified-test#solution_2
+[how-to-run-test-in-file]: ./guides/how-to-run-specified-test#solution_1
+[how-to-skip-tests]: ./guides/how-to-skip-test-in-browsers
+[how-to-check-test-stability]: ./guides/how-to-check-test-stability
+[testplane-sets]: ./config/sets
+[retry-limiter]: ./plugins/retry-limiter
+[retry-progressive]: ./plugins/testplane-retry-progressive
+[sharp]: https://github.com/lovell/sharp
+[sessions-reuse]: ./config/browsers#tests_per_session
+[patterns-on-reject]: ./config/system#patterns_on_reject
+[assert-view-opts]: ./config/browsers#assert_view_opts
+[assert-view]: ./commands/browser/assertView
+[how-to-use-cdp]: ./guides/how-to-use-cdp
+[testplane-profiler]: https://github.com/gemini-testing/testplane-profiler
+[testplane-plugins-profiler]: https://github.com/gemini-testing/testplane-plugins-profiler
+[how-to-test-layout-under-login]: ./guides/how-to-test-layout-under-login
+[how-to-read-browser-logs]: ./guides/how-to-read-browser-logs
+[prepare-browser]: ./config/main#config_prepare_browser
+[defaults]: ./config/browsers#timeouts
+[commands]: ./commands/overview
+[html-reporter]: ./html-reporter/html-reporter-setup
+[html-reporter-diff]: ./html-reporter/html-reporter-setup#setup_diff_mode
+[html-reporter-gui]: ./html-reporter/html-reporter-commands#gui
+[plugins]: https://github.com/gemini-testing/
+[testplane-events]: ./reference/testplane-events
+[html-reporter-extension-points]: ./html-reporter/html-reporter-plugins#extension_points
+[testplane-cli]: ./reference/testplane-events#cli
+[html-reporter-plugins]: ./html-reporter/html-reporter-plugins
+[testplane-workers]: ./config/system#workers
diff --git a/docs/intro.md b/docs/intro.md
deleted file mode 100644
index b8046c8..0000000
--- a/docs/intro.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-sidebar_position: 1
----
-
-# Intro
-
-Welcome to Testplane docs.
diff --git a/docs/migrations/how-to-upgrade-hermione-to-4.mdx b/docs/migrations/how-to-upgrade-hermione-to-4.mdx
new file mode 100644
index 0000000..6837ecc
--- /dev/null
+++ b/docs/migrations/how-to-upgrade-hermione-to-4.mdx
@@ -0,0 +1,477 @@
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+import Admonition from "@theme/Admonition";
+
+# Как обновить hermione до версии 4.x
+
+<Admonition type="warning">
+    Данный рецепт актуален только для тех проектов, которые используют hermione младше 4-й версии.
+</Admonition>
+
+## Почему стоит обновиться? {#why_to_upgrade}
+
+Когда-то очень давно hermione перешла на «временный» форк пакета [webdriverio@4][webdriverio] _(сокр. wdio)_, который она использовала «под капотом», т. к. проблемы во _внешнем_ _wdio_ тормозили её разработку: постоянные баги в _wdio,_ разногласия относительно вносимых изменений и т. п. И если сначала форк регулярно обновлялся командой hermione, чтобы предоставить пользователю актуальную функциональность, то со временем форк значительно отстал от текущей версии _wdio_ во внешнем мире.
+
+К тому времени во внешнем мире в _wdio_ уже появилось много различных фич, которые интересны разработчикам: [Chrome DevTools Protocol (CDP)][how-to-use-cdp], [стабы внешних запросов][how-to-intercept-requests-and-responses], расширенные возможности работы с мобильными устройствами и т. п. Поэтому у команды hermione не осталось выбора: нужно было отказываться от форка _webdriverio@4_ и переходить на самую актуальную версию _webdriverio@7_.
+
+<Admonition type="info">
+    Сейчас уже доступна 8-я версия _webdriverio_ и _hermione@7_ уже использует её.
+</Admonition>
+
+Кроме этого, пользователям становилось всё неудобнее пользоваться устаревшими командами: тайпинги приходилось подключать из отдельного пакета (в новом _wdio_ они поставляются из коробки), за документацией по командам приходилось ходить на [старый сайт][webdriverio-v4-api], в то время как некоторые пользователи иногда заходили на [актуальную страницу][webdriverio-api] и не могли понять, почему команды из документации не работают в hermione.
+
+Таким образом, причин для радикального апгрейда — сразу на 3 мажора вверх — накопилось достаточно.
+
+## Что изменилось? {#what_is_new}
+
+Изменений очень много, поэтому ниже будут перечислены только самые важные / интересные из них.
+
+### API команд {#api_changes}
+
+#### async/await вместо чейнинга {#feature_async_await}
+
+В новой версии теперь нельзя писать тесты, используя _chaining_. Доступен только _async/await_-синтаксис:
+
+<Tabs>
+<TabItem value="Было" label="Было">
+```javascript
+  it('some test', function() {
+      return this.browser
+          .foo()
+          .bar()
+          .baz();
+  });
+  ```
+</TabItem>
+
+<TabItem value="Стало" label="Стало">
+```javascript
+  it('some test', async function() {
+      await this.browser.foo();
+      await this.browser.bar();
+      await this.browser.baz();
+  });
+  ```
+</TabItem>
+
+</Tabs>
+
+А начиная с версии [hermione@4.9.0](https://github.com/gemini-testing/hermione/blob/master/CHANGELOG.md#490-2022-05-24) можно писать тесты ещё короче, так как hermione теперь передает в функцию объект с полем `browser`:
+
+```javascript
+it("some test", async function ({ browser }) {
+    await browser.foo();
+    await browser.bar();
+    await browser.baz();
+});
+```
+
+<Admonition type="warning">
+    Далее в примерах «Стало» мы будем везде предполагать, что речь идет о hermione с версией не
+    меньше, чем _4.9.0_. Если по какой-то причине вы планируете использовать версию hermione _4+_
+    младше _4.9.0_, то к браузеру в тестах нужно обращаться как и раньше — через _this_, например:
+    _await this.browser.getText('.selector')_.
+</Admonition>
+
+#### Результат вместо объекта с ключом value {#feature_direct_result}
+
+Теперь при получении результатов команд вместо объекта с ключом `value` возвращается реальный результат (старое поведение часто приводило к ошибкам в тестах):
+
+<Tabs>
+<TabItem value="Было" label="Было">
+```javascript
+  it('some test', async function() {
+      const { value } = await this.browser.getText('.selector');
+      console.log(value); // some text
+  });
+  ```
+</TabItem>
+
+<TabItem value="Стало" label="Стало">
+```javascript
+  it('some test', async function({ browser }) {
+      const text = await browser.getText('.selector');
+      console.log(text); // some text
+  });
+  ```
+</TabItem>
+
+</Tabs>
+
+#### Работа с элементами напрямую {#feature_commands_of_elements}
+
+С помощью команды [`browser.$`][browser-dollar] можно получить инстанс найденного элемента и работать с ним в тесте. Это удобно, когда с элементом нужно взаимодействовать больше одного раза (при этом элемент не будет повторно искаться на странице):
+
+<Tabs>
+<TabItem value="Было" label="Было">
+```javascript
+  it('some test', async function() {
+      await this.browser.clearElement('.input');
+      await this.browser.setValue('.input', 'text');
+  });
+  ```
+</TabItem>
+
+<TabItem value="Стало" label="Стало">
+```javascript
+  it('some test', async function({ browser }) {
+      const elem = await browser.$('.input');
+
+      await elem.clearElement();
+      await elem.setValue('text');
+
+});
+
+````
+</TabItem>
+
+</Tabs>
+
+Смотрите также команды:
+
+* [`browser.$$`][browser-dollar-dollar]
+* [`element.$`][element-dollar]
+* [`element.$$`][element-dollar-dollar]
+
+#### Передача аргументов через объект {#feature_passing_args_as_object}
+
+Для многих команд аргументы теперь передаются с помощью объекта с понятными ключами вместо последовательной передачи аргументов, в которых было очень легко запутаться. Например, в команде [waitForExist][element-wait-for-exist], в которой в качестве аргументов раньше передавались даже булевые значения:
+
+<Tabs>
+<TabItem value="Было" label="Было">
+```javascript
+it('some test', async function() {
+    await this.browser.waitForExist('.selector', 1000, true);
+});
+````
+
+</TabItem>
+
+<TabItem value="Стало" label="Стало">
+```javascript
+  it('some test', async function({ browser }) {
+      const elem = await browser.$('.selector');
+
+      await elem.waitForExist({
+          timeout: 1000,
+          interval: 500,
+          reverse: true,
+          timeoutMsg: 'still exists'
+      });
+
+});
+
+````
+</TabItem>
+
+</Tabs>
+
+#### Специальная команда для React {#feature_commands_for_react}
+
+Бонус для тех, кто уже перешел на React — теперь в тестах можно использовать команды [`browser.react$`][browser-react-dollar] и [`browser.react$$`][browser-react-dollar-dollar] для поиска на странице конкретных react-компонентов с определенными состояниями. Аналогичные команды есть и для элементов — [`element.react$`][element-react-dollar] и [`element.react$$`][element-react-dollar-dollar].
+
+Также читайте [статью о вариантах работы с react-компонентами][react-selectors] на сайте _webdriverio_.
+
+Пример использования:
+
+<Tabs>
+<TabItem value="Было" label="Было">
+```javascript
+it('some test', async function() {
+    // специальных команд для работы с react-компонентами – нет :(
+});
+````
+
+</TabItem>
+
+<TabItem value="Стало" label="Стало">
+```javascript
+  it('some test', async function({ browser }) {
+      const component = await browser.react$('MyComponent', {
+          props: { someProp: true },
+          state: 'some-state'
+      });
+
+      const result = await component.isDisplayed();
+
+});
+
+````
+</TabItem>
+
+</Tabs>
+
+### Актуальная документация {#feature_actual_docs}
+
+Пока hermione использовала старую версию _webdriverio@4_, приходилось все время уточнять, что документация на все команды лежит по отдельному адресу: [v4.webdriver.io/api.html][webdriverio-v4-api]. Теперь же описания всех команд _webdriverio_, которые используются hermione, можно найти по стандартному адресу: [webdriver.io/docs/api][webdriverio-api].
+
+Помимо этого, мы [перевели описания всех команд на русский язык][hermione-commands] и адаптировали все примеры использования этих команд под hermione, так как в _webdriverio_ свой раннер и примеры в его документации неприменимы напрямую в hermione.
+
+### Тесты выполняются быстрее {#feature_running_tests_faster}
+
+При локальных прогонах нескольких тестов вы, скорее всего, этого ускорения не заметите, но на большом количестве тестов это будет весьма ощутимо. Новые команды работают быстрее примерно на 15% (при условии, что вы отказались от использования старых команд).
+
+### Простой запуск тестов на локальном браузере {#feature_running_tests_in_local_browser}
+
+Раньше для того, чтобы запустить тесты локально на своем браузере, нужно было запустить `selenium-standalone` и указать hermione магический `gridUrl`, чтобы все заработало. Сейчас же — достаточно в конфиге указать браузеру опцию `automationProtocol` со значением `devtools`:
+
+```javascript
+// hermione.conf.js
+module.exports = {
+  browsers: {
+      chrome: {
+          automationProtocol: 'devtools',
+          desiredCapabilities: {
+              // ...
+          }
+      }
+  },
+
+  // другие настройки hermione...
+};
+````
+
+Также мы планируем добавить отдельную кнопку в hermione GUI для перехода в CDP-режим, чтобы было еще проще.
+
+<Admonition type="warning">
+    * На данный момент это полноценно поддержано только в браузере _Chrome_. * Переснимать скриншоты
+    в таком режиме можно только для дебага, т. к. в конвейере браузеры запускаются под _Linux_,
+    соответственно: рендеринг страницы будет отличаться и в пулл-реквесте тесты упадут с диффом.
+</Admonition>
+
+### API для стаба походов по сети {#feature_api_to_mock_network}
+
+В новой версии доступна возможность застабать ответы вашего сервиса или переопределить их. Делается это с помощью команды [mock.respond()][mock]. Также можно запрещать походы по урлам внешних сервисов.
+
+Более подробно о всех возможностях читайте в рецепте «[Как отслеживать и перехватывать сетевые запросы и ответы][how-to-intercept-requests-and-responses]».
+
+<Admonition type="warning">
+    На данный момент эта функциональность работает только в режиме _Chrome DevTools Protocol (CDP)_,
+    который работает только в _Chrome_ и _Firefox Nightly_.
+</Admonition>
+
+### Конфигурация браузеров в конфиге {#browsers_config}
+
+Для браузеров, поддерживающих работу W3C-протокола, вместо поля `version` нужно указывать `browserVersion`. А для дополнительных опций нужно добавлять префикс браузера:
+
+<Tabs>
+<TabItem value="Было" label="Было">
+```javascript
+  module.exports = {
+      browsers: {
+          'chrome-desktop': {
+              desiredCapabilities: {
+                  browserName: 'chrome',
+                  version: '75',
+                  'chromeOptions': {
+                      // ...
+                  }
+              }
+          }
+      }
+  };
+  ```
+</TabItem>
+
+<TabItem value="Стало" label="Стало">
+```javascript
+  module.exports = {
+      browsers: {
+          'chrome-desktop': {
+              desiredCapabilities: {
+                  browserName: 'chrome',
+                  browserVersion: '75',
+                  'goog:chromeOptions': { // для браузера Chrome нужен префикс 'goog'
+                      // ...
+                  }
+              }
+          }
+      }
+  };
+  ```
+</TabItem>
+
+</Tabs>
+
+Подробнее про вендорные префиксы читайте по [ссылке](https://w3c.github.io/webdriver/#protocol-extensions).
+
+Список всех доступных настроек можно посмотреть в [спецификации](https://w3c.github.io/webdriver/#capabilities).
+
+## Как переехать? {#how_to_move}
+
+Мы обновились сразу на 3 мажора _webdriverio_, поэтому просто обновить версию hermione в `package.json` не получится. Основные проблемы при переезде — это отсутствующий _chaining_ в тестах и устаревшие команды тестов. Чтобы вам было проще разобраться с обеими проблемами, мы написали для вас следующую инструкцию.
+
+### 1. Обновите hermione до 4+, установите плагин мигратора и кодмод {#update_hermione_and_install_plugin_and_codmode}
+
+А именно:
+
+-   обновите версию hermione до hermione@4.0.0;
+-   установите плагин [hermione-wdio-migrator][hermione-wdio-migrator] для плавной миграции команд;
+-   установите пакет [hermione-codemod][hermione-codemod] для конвертации существующих тестов в новый синтаксис;
+
+Всё это вы можете сделать одной командой:
+
+```shell
+npm install -D hermione@4.0.0 hermione-wdio-migrator hermione-codemod --save-exact
+```
+
+Версии всех плагинов hermione (например, [html-reporter][html-reporter]) также необходимо обновить до последних версий, т. к. часть из них может работать неправильно с новой версией hermione.
+
+### 2. Запустите кодмод на async/await {#change_to_async_await_by_codmode}
+
+Кодмод перегенерит ваши тесты с _chaining_-формата в формат _async/await:_
+
+<Tabs>
+<TabItem value="zsh" label="zsh">
+Если вы используете командный процессор _zsh_, то файлы тестов можно передавать не только в виде относительных путей, но и в виде глобов, например: _somefolder/**/*.js_ и т. п.
+
+    ```shell
+    npx jscodeshift -t node_modules/hermione-codemod/transforms/browser-chaining-to-async-await.js path_to_file_mask
+    ```
+
+</TabItem>
+
+<TabItem value="bash" label="bash">
+Если вы используете командный процессор _bash_, то задавать пути в виде глобов как в _zsh_ не получится, поэтому команда будет сложнее, если вам нужно обработать группу файлов. Например:
+
+    ```shell
+    npx jscodeshift -t node_modules/hermione-codemod/transforms/browser-chaining-to-async-await.js $(find ./somefolder -type f -iname '*.js' | xargs echo)
+    ```
+
+</TabItem>
+
+</Tabs>
+
+При успешном завершении вы увидите соответствующее сообщение:
+
+```shell
+Results:
+0 errors
+0 unmodified
+0 skipped
+251 ok
+```
+
+Но бывают и кейсы, с которыми текущий кодмод не может справиться. Для таких тестов будет выведена ошибка с информацией о проблемном файле:
+
+```shell
+WARN: can't correctly transform ConditionalExpression, fix it manually
+      file: tests/hermione/suites/common/promotion-page/promotion-page.hermione.js
+      position: {"start":112,"end":116}
+```
+
+Такие тесты придется править руками. Мы старались учесть большинство тестов, поэтому таких случаев должно быть не очень много.
+
+После этого вы **уже** можете вливать свои изменения (это не обязательно), чтобы выполнять переезд по частям. Дело в том, что в _wdio@4_ синтаксис _async/await_ тоже будет работать. Т. е. вы всегда могли писать тесты таким образом (а некоторые сервисы уже давно так и делали).
+
+### 3. Запустите кодмод на удаление value {#remove_value_by_codmode}
+
+Так как теперь при получении результатов команд вместо объекта с ключом `value` возвращается реальный результат, нужно изменить во всех тестах сохранение результата. Следующий кодмод предназначен именно для этого случая.
+
+Команда очень похожа на предыдущую, меняется только путь к файлу реализации очередного кодмода:
+
+```shell
+npx jscodeshift -t node_modules/hermione-codemod/transforms/remove-browser-prop.js path_to_file_mask
+```
+
+При наличии ворнингов проблемные тесты нужно будет исправить вручную. Например, если в рамках одного теста есть многократное использование `value` через деструктуризацию, то кодмод с таким не справится и в коде теста получится несколько переменных с одним именем. Например:
+
+```javascript
+// тест на wdio@4:
+it('test', function(){
+    return this.browser
+        ...
+        .getText('.button')
+        .then((value) => {
+            assert.equal(value, 'Кнопка', 'Нам нужна кнопка');
+        })
+        ...
+        .getValue('.input')
+        .then((value) => {
+            assert.equal(value, 'Привет', 'С нами не поздоровались');
+        });
+});
+
+// перегенерится для wdio@7 в такой формат:
+it('test', async function() {
+    const value = await this.browser.getText('.button');
+    assert.equal(value, 'Кнопка', 'Нам нужна кнопка');
+    ...
+    // здесь будет ошибка из-за повторного использования названия переменной,
+    // поэтому кодмод выдаст ворнинг о проблемном месте
+    const value = await this.browser.getValue('.input');
+    assert.equal(value, 'Привет', 'С нами не поздоровались');
+});
+```
+
+Если при запуске кодмодов в вашем проекте оказалось слишком много тестов, которые не поддаются автоматической миграции, то обратитесь, пожалуйста, в [github issues][gh-issues] за помощью. Мы проанализируем эти ошибки и поможем с переездом.
+
+### 4. Добавьте hermione-wdio-migrator в конфиг hermione {#add_migrator}
+
+Этот плагин «под капотом» просто добавляет реализацию старых команд с помощью нового API, чтобы в момент переезда вам не пришлось актуализировать тесты самостоятельно. В дальнейшем, конечно, нужно будет в своих тестах заменить эти устаревшие команды на новые:
+
+```javascript
+module.exports = {
+    plugins: {
+        "hermione-wdio-migrator": {
+            enabled: true,
+        },
+
+        // остальные плагины hermione...
+    },
+
+    // другие настройки hermione...
+};
+```
+
+### 5. Удалите кодмод {#remove_codemod}
+
+Пакет [hermione-codemod][hermione-codemod] нужно деинсталлировать, т. к. в дальнейшем он не понадобится.
+
+```shell
+npm uninstall hermione-codemod
+```
+
+### 6. Запустите линтеры {#run_linters}
+
+Нужно запустить линтеры на измененные тесты, т. к. кодмод мог нарушить правила написания кода в вашем проекте.
+
+### 7. Запустите тесты {#run_tests}
+
+На последнем шаге нужно убедиться, что все тесты успешно проходят, например, создав пулл-реквест и проверив, что все тесты успешно выполнились в CI.
+
+## Заключение {#conclusion}
+
+Обновление _webdriverio_ принесло много полезных вещей. Некоторыми можно пользоваться уже сейчас, некоторые в более удобном виде появятся чуть позже. Поэтому, мы крайне настоятельно рекомендуем переезжать на новую версию, чтобы написание тестов стало более удобным, быстрым и приятным.
+
+<Admonition type="warning">
+    Старая версия hermione находится в режиме ограниченной поддержки и новые фичи в ней появляться
+    не будут.
+</Admonition>
+
+## Поддержка {#support}
+
+Если при переезде на новую версию вы столкнетесь с проблемами, или у вас возникнут какие-либо вопросы, то приходите в [github issues][gh-issues] — и мы обязательно вам поможем!
+
+[how-to-use-cdp]: ../guides/how-to-use-cdp
+[how-to-intercept-requests-and-responses]: ../guides/how-to-intercept-requests-and-responses
+[webdriverio]: https://webdriver.io
+[webdriverio-api]: https://webdriver.io/docs/api
+[webdriverio-v4-api]: http://v4.webdriver.io/api.html
+[browser-dollar]: ../commands/browser/_dollar
+[browser-dollar-dollar]: ../commands/browser/_dollardollar
+[element-dollar]: ../commands/element/_dollar
+[element-dollar-dollar]: ../commands/element/_dollardollar
+[element-wait-for-exist]: ../commands/element/waitForExist
+[browser-react-dollar]: ../commands/browser/reactDollar
+[browser-react-dollar-dollar]: ../commands/browser/reactDollarDollar
+[element-react-dollar]: ../commands/element/reactDollar
+[element-react-dollar-dollar]: ../commands/element/reactDollarDollar
+[react-selectors]: https://webdriver.io/docs/selectors/#react-selectors
+[mock]: ../commands/mock/respond
+[hermione-commands]: ../commands/overview
+[hermione-wdio-migrator]: https://github.com/gemini-testing/hermione-wdio-migrator
+[hermione-codemod]: https://github.com/gemini-testing/hermione-codemod
+[html-reporter]: ../html-reporter/html-reporter-setup
+[gh-issues]: https://github.com/gemini-testing/testplane/issues/
diff --git a/docs/migrations/how-to-upgrade-hermione-to-5.mdx b/docs/migrations/how-to-upgrade-hermione-to-5.mdx
new file mode 100644
index 0000000..2b03bb0
--- /dev/null
+++ b/docs/migrations/how-to-upgrade-hermione-to-5.mdx
@@ -0,0 +1,77 @@
+import Admonition from "@theme/Admonition";
+
+# Как обновить hermione до версии 5.x
+
+<Admonition type="warning">
+Если в вашем проекте hermione младше 4-й версии, то прочтите «[Как обновить hermione до версии 4.x][how-to-upgrade-hermione-to-4]», прежде чем обновлять hermione до 5-й версии.
+
+Мы рекомендуем вам обновлять hermione поэтапно, убеждаясь на каждом этапе, что все тесты проекта корректно выполняются.
+
+</Admonition>
+
+## Что изменилось? {#what_is_new}
+
+### Новые дефолты в конфиге {#changes_in_config_options}
+
+Первое, на что стоит обратить внимание при переезде, — это изменение дефолтных значений некоторых опций в конфиге. Все изменения направлены на то, чтобы при базовой настройке hermione тесты проходили быстрее, а после прогона оставалось больше информации о тестах.
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Было**</td><td>**Стало**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[antialiasingTolerance][antialiasing-tolerance]</td><td>0</td><td>4</td><td>Задает чувствительность определения антиалиасинга, который будет игнорироваться при сравнении скриншотов.</td></tr>
+<tr><td>[compositeImage][composite-image]</td><td>false</td><td>true</td><td>Позволяет тестировать элементы, не влезающие во вьюпорт по высоте.</td></tr>
+<tr><td>[saveHistory][save-history]</td><td>false</td><td>true</td><td>Сохранять историю всех выполненных команд.</td></tr>
+<tr><td>[takeScreenshotOnFails.assertViewFail][take-screenshot-on-fails-assert-view-fail]</td><td>false</td><td>true</td><td>Определяет снимать ли скриншот страницы браузера _(Page Screenshot)_ при падении теста, а также при падении команды _assertView_.</td></tr>
+<tr><td>[takeScreenshotOnFailsMode][take-screenshot-on-fails-mode]</td><td>"viewport"</td><td>"fullpage"</td><td>Режим снятия скриншота при падении теста. Доступные значения: _viewport_ и _fullpage_.</td></tr>
+<tr><td>[takeScreenshotOnFailsTimeout][take-screenshot-on-fails-timeout]</td><td>90000</td><td>5000</td><td>Таймаут для снятия скриншота страницы браузера _(Page Screenshot)_ при падении теста, в мс.</td></tr>
+<tr><td>[httpTimeout][http-timeout]</td><td>90000</td><td>30000</td><td>Таймаут для любых запросов к Selenium-серверу, в мс.</td></tr>
+<tr><td>[pageLoadTimeout][page-load-timeout]</td><td>300000</td><td>20000</td><td>Таймаут для полной загрузки страницы, в мс.</td></tr>
+<tr><td>[sessionQuitTimeout][session-quit-timeout]</td><td>90000</td><td>5000</td><td>Таймаут для завершения сессии, в мс.</td></tr>
+
+</tbody>
+</table>
+
+Кроме этого, удалены опции `screenshotOnReject` и `screenshotOnRejectTimeout`, которые ранее были объявлены как устаревшие _(deprecated)_.
+
+Подробнее про все эти опции можно почитать [здесь][config-browsers]. Если новые значения вас устраивают и нет явных причин их переопределять, то этот пункт при миграции можно пропустить.
+
+### Отчеты в CLI {#changes_in_reporters}
+
+В данном разделе речь идет не про html-отчет, а про CLI-репортеры, которые поставляются из коробки.
+
+-   Удален teamcity-репортер, т. к. в самой hermione он смотрелся чужеродно. Если вы всё же используете такой отчет, то можно использовать плагин [hermione-teamcity-reporter][hermione-teamcity-reporter].
+-   Опция `-r`, с помощью которой раньше можно было указать тип репортера, теперь этим не занимается. Чаще всего такое сокращение имени используется для опции `--require`. Многие путались в этом месте и мы решили это поправить. Сам репортер вы всё еще можете указать при помощи опции `--reporter`.
+-   Если вы захотите добавить свой репортер, то в его реализации обязательно должен быть метод `create` для инициализации.
+
+Итого, если вы не использовали teamcity-репортер или не писали свои новые, то этот пункт при миграции можно пропустить.
+
+### testParserAPI {#changes_in_test_parser_api}
+
+Теперь объект [testParser][test-parser], который можно было получить, подписавшись на событие [BEFORE_FILE_READ][before-file-read], не является инстансом `EventEmitter`. Это значит, что теперь нельзя с помощью него подписаться на события [SUITE_BEGIN][event-suite-begin] и [TEST_BEGIN][event-test-begin].
+
+Справедливости ради, оно изначально работало неправильно и никто это не использовал. Поэтому, эта возможность была удалена. Про все доступные события можно почитать [здесь][hermione-events].
+
+## Поддержка {#support}
+
+Если при переезде на новую версию вы столкнетесь с проблемами, или у вас возникнут какие-либо вопросы, то приходите в [github issues][gh-issues] — и мы обязательно вам поможем!
+
+[how-to-upgrade-hermione-to-4]: ../migrations/how-to-upgrade-hermione-to-4
+[config-browsers]: ../config/browsers
+[hermione-teamcity-reporter]: https://github.com/gemini-testing/hermione-teamcity-reporter
+[before-file-read]: ../reference/hermione-events#before_file_read
+[event-suite-begin]: ../reference/hermione-events#suite_begin
+[event-test-begin]: ../reference/hermione-events#test_begin
+[test-parser]: ../reference/hermione-events#test_parser
+[hermione-events]: ../reference/hermione-events
+[antialiasing-tolerance]: ../config/browsers#antialiasing_tolerance
+[composite-image]: .../config/browsers#composite_image
+[take-screenshot-on-fails-assert-view-fail]: ../config/browsers#take_screenshot_on_fails
+[take-screenshot-on-fails-mode]: ../config/browsers#take_screenshot_on_fails_mode
+[take-screenshot-on-fails-timeout]: ../config/browsers#take_screenshot_on_fails_timeout
+[http-timeout]: ../config/browsers#http_timeout
+[page-load-timeout]: ../config/browsers#page_load_timeout
+[session-quit-timeout]: ../config/browsers#session_quit_timeout
+[save-history]: ../config/browsers#save_history
+[gh-issues]: https://github.com/gemini-testing/testplane/issues/
diff --git a/docs/migrations/how-to-upgrade-hermione-to-6.mdx b/docs/migrations/how-to-upgrade-hermione-to-6.mdx
new file mode 100644
index 0000000..56e2c10
--- /dev/null
+++ b/docs/migrations/how-to-upgrade-hermione-to-6.mdx
@@ -0,0 +1,51 @@
+import Admonition from "@theme/Admonition";
+
+# Как обновить hermione до версии 6.x
+
+<Admonition type="warning">
+Если в вашем проекте hermione младше 4-й версии, то прочтите сначала «[Как обновить hermione до версии 4.x][how-to-upgrade-hermione-to-4]» и «[Как обновить hermione до версии 5.x][how-to-upgrade-hermione-to-5]».
+
+Мы рекомендуем вам обновлять hermione поэтапно, убеждаясь на каждом этапе, что все тесты проекта корректно выполняются.
+
+</Admonition>
+
+## Что изменилось? {#what_is_new}
+
+### Отказ от поддержки Node.JS < 14.x {#dropped_nodejs_less_than_14x}
+
+В этом мажоре hermione перестала поддерживать версии _Node.JS < 14.x_.
+
+Если у вас в проекте версия _Node.JS_ уже _14.x_ или выше и этот пункт для вас не актуален, то [для получения свежих фич][hermione-new-features] мы всё же рекомендуем вам обновить hermione до 6-й версии.
+
+### browserWSEndpoint {#added_browser_ws_endpoint_setting}
+
+Теперь в настройках браузера появилась опция [browserWSEndpoint][browser-ws-endpoint], с помощью которой можно переопределить ссылку для доступа к браузерам через [Chrome DevTools Protocol (CDP)][how-to-use-cdp].
+
+Пример настройки:
+
+```javascript
+//.hermione.conf.js
+const gridHost = "localhost";
+
+module.exports = {
+    gridUrl: `https://${gridHost}/:4444/wd/hub`,
+    browserWSEndpoint: `ws:${gridHost}/wd/hub`,
+
+    // другие настройки hermione...
+};
+```
+
+<Admonition type="warning">
+    Данная настройка не будет работать, если у вас в проекте слишком старая версия браузера.
+    Гарантированно будет работать в Хроме, начиная с версии 101.
+</Admonition>
+
+## Поддержка {#support}
+
+Если при переезде на новую версию вы столкнетесь с проблемами, или у вас возникнут какие-либо вопросы, то приходите в [github issues][gh-issues] — и мы обязательно вам поможем!
+
+[how-to-upgrade-hermione-to-4]: ../migrations/how-to-upgrade-hermione-to-4
+[how-to-upgrade-hermione-to-5]: ../migrations/how-to-upgrade-hermione-to-5
+[browser-ws-endpoint]: ../config/browsers#browser_ws_endpoint
+[how-to-use-cdp]: ../guides/how-to-use-cdp.md
+[gh-issues]: https://github.com/gemini-testing/testplane/issues
diff --git a/docs/migrations/how-to-upgrade-hermione-to-7.mdx b/docs/migrations/how-to-upgrade-hermione-to-7.mdx
new file mode 100644
index 0000000..0cd55f3
--- /dev/null
+++ b/docs/migrations/how-to-upgrade-hermione-to-7.mdx
@@ -0,0 +1,137 @@
+import Admonition from "@theme/Admonition";
+
+# Как обновить hermione до версии 7.x
+
+<Admonition type="warning">
+Если в вашем проекте hermione младше 4-й версии, то прочтите сначала «[Как обновить hermione до версии 4.x][how-to-upgrade-hermione-to-4]», «[Как обновить hermione до версии 5.x][how-to-upgrade-hermione-to-5]» и «[Как обновить hermione до версии 6.x][how-to-upgrade-hermione-to-6]».
+
+Мы рекомендуем вам обновлять hermione поэтапно, убеждаясь на каждом этапе, что все тесты проекта корректно выполняются.
+
+</Admonition>
+
+## Что изменилось? {#what_is_new}
+
+### Мажорные изменения {#major_changes}
+
+#### Отказ от поддержки Node.JS < 16.x {#dropped_nodejs_less_than_16x}
+
+В этом мажоре hermione перестала поддерживать версии _Node.JS < 16.x_.
+
+#### Обработка unhandled rejection {#handle_unhandled_rejection}
+
+При возникновении ошибки `Unhandled rejection` в мастере или воркерах hermione теперь выполняем _graceful shutdown_. Это означает, что все последующие тесты в очереди завершаются с ошибкой `Browser request was cancelled` и сама hermione завершается с `exit code 1`.
+
+Данное изменение необходимо, чтобы защитить пользователей от написания некорректных тестов. Пример теста с ошибкой:
+
+```typescript
+it("test", async ({ browser }) => {
+    await browser.url("https://yandex.ru/search/?text=aaa");
+    expect(browser).toHaveUrlContaining("foo-bar-baz");
+});
+```
+
+Внимательный читатель заметит, что я забыл указать `await` перед вызовом `expect`. В этом случае тест сразу после перехода по урлу завершится успешно. И только потом вылетит ошибка с `Unhandled rejection`, которую hermione@6 проглатывает. А hermione@7 перехватит и экстренно завершит запуск тестов. К сожалению, определить из какого теста вылетела ошибка `Unhandled rejection` невозможно. Так как тест может быть написан, например, так:
+
+```typescript
+it("test2", async () => {
+    new Promise((resolve, reject) => {
+        setTimeout(() => {
+            reject("Something goes wrong");
+        }, 30000);
+    });
+});
+```
+
+Т.е. данный тест сразу же выполнится успешно и только через 30 секунд (с учетом того, что в очереди еще есть тесты на запуск) вылетит `Unhandled rejection`.
+
+Соответственно, для поиска проблемного теста нужно будет посмотреть в лог выполнения и найти последние выполнившиеся тесты перед информацией об ошибке. Ошибка будет выглядеть примерно так:
+
+```bash
+[13:48:57 GMT+3] Unhandled Rejection in hermione:worker:10830:
+Promise: {}
+Reason: Something goes wrong
+[13:48:57 GMT+3] Terminating on critical error: Unhandled Rejection in hermione:worker:10830:
+Promise: {}
+Reason: Something goes wrong
+```
+
+#### test.id и suite.id теперь свойства {#test_id_and_suite_id_are_properties}
+
+`id` для теста и сьюта теперь является свойством, а не методом, и, соответственно, необходимо его использовать как `test.id` или `suite.id`. Вызов `test.id` обычно используется в конфиге hermione для определения опции [screenshotsDir][screenshots-dir].
+
+#### Удалена опция saveHistory из конфига {#removed_save_history_option_from_config}
+
+Удалена опция [saveHistory][save_history] из конфига. Теперь необходимо использовать [saveHistoryMode][save_history_mode] с доступными значениями: `all`, `none`, `onlyFailed`. По умолчанию используется `all`, т.е. история сохраняется для всех тестов. Соответственно, можно данную опцию не выставлять явно.
+
+### Минорные изменения {#minor_changes}
+
+-   переехали с [webdriverio@7][webdriverio@7] на [webdriverio@8][webdriverio@8];
+-   ускорили время чтения тестов примерно в 3 раза, теперь тесты читаются один раз в мастере (раньше читались для каждого браузера отдельно);
+-   поддержали возможность писать конфиг на TS. Т.е. можно создать `.hermione.conf.ts` и hermione его сама скомпилирует и прочитает (если пользователь имеет в своем проекте пакет `ts-node`);
+-   добавили временных меток в логи hermione. Выглядят так:
+
+    ```bash
+    [13:48:09 GMT+3] ✓ suite test2 [chrome-desktop:SESSION_ID] - 875ms
+    ```
+
+### Патчевые изменения {#patch_changes}
+
+-   поддержали корректное снятие скриншотов в девайсах, имеющих дробный `pixelRatio` (например, `google pixel`). Ранее скриншоты в таких девайсах снимались некорректно;
+-   отвод курсора с помощью опции `resetCursor: true` теперь не ругается, если левый верхний угол элемента `body` имеет отрицательные координаты.
+
+## Как переехать? {#how_to_move}
+
+### 1. Обновить hermione до 7+ и плагины до последних версий {#update_hermione_and_plugins}
+
+А именно:
+
+-   [hermione][hermione]
+-   [html-reporter][html-reporter]
+-   [hermione-hide-scrollbars][hermione-hide-scrollbars]
+-   [hermione-safari-commands][hermione-safari-commands]
+-   [hermione-wdio-migrator][hermione-wdio-migrator]
+-   [json-reporter][json-reporter]
+-   [hermione-passive-browsers][hermione-passive-browsers]
+
+Если какой-то из плагинов не используется, то устанавливать его не нужно.
+
+### 2. В конфиге hermione заменить test.id() на test.id {#replace_test_id_method_on_test_id_property}
+
+Если `test.id()` не используется, то ничего делать не нужно.
+
+### 3. В конфиге hermione заменить опцию saveHistory на saveHistoryMode {#replace_save_history_on_save_history_mode}
+
+Если [saveHistory][save_history] не используется, то ничего делать не нужно.
+
+### 4. Заменить использование кастомного моковского интерфейса {#replace_custom_mocha_interface}
+
+Если используется кастомный моковский интерфейс, то необходимо заменить его на интерфейс моки из зависимостей hermione:
+
+```javascript
+- const baseBdd = require('@gemini-testing/mocha/lib/interfaces/bdd');
+
++ const { dependencies: hermioneDeps } = require('hermione/package');
++ const mochaModule = '@gemini-testing/mocha' in hermioneDeps ? '@gemini-testing/mocha' : 'mocha';
++ const { interfaces: { bdd: baseBdd } } = require(mochaModule);
+```
+
+## Поддержка {#support}
+
+Если при переезде на новую версию вы столкнетесь с проблемами, или у вас возникнут какие-либо вопросы, то приходите в [github issues][gh-issues] — и мы обязательно вам поможем!
+
+[how-to-upgrade-hermione-to-4]: ../migrations/how-to-upgrade-hermione-to-4
+[how-to-upgrade-hermione-to-5]: ../migrations/how-to-upgrade-hermione-to-5
+[how-to-upgrade-hermione-to-6]: ../migrations/how-to-upgrade-hermione-to-6
+[screenshots-dir]: ../config/browsers#screenshots_dir
+[save_history]: ../config/browsers#save_history
+[save_history_mode]: ../config/browsers#save_history_mode
+[webdriverio@7]: https://webdriver.io/
+[webdriverio@8]: https://webdriver.io/
+[gh-issues]: https://github.com/gemini-testing/testplane/issues/
+[hermione]: https://github.com/gemini-testing/hermione
+[html-reporter]: https://github.com/gemini-testing/html-reporter
+[hermione-hide-scrollbars]: https://github.com/gemini-testing/hermione-hide-scrollbars
+[hermione-safari-commands]: https://github.com/gemini-testing/hermione-safari-commands
+[hermione-wdio-migrator]: https://github.com/gemini-testing/hermione-wdio-migrator
+[json-reporter]: https://github.com/gemini-testing/json-reporter
+[hermione-passive-browsers]: https://github.com/gemini-testing/hermione-passive-browsers
diff --git a/docs/migrations/how-to-upgrade-hermione-to-8.mdx b/docs/migrations/how-to-upgrade-hermione-to-8.mdx
new file mode 100644
index 0000000..45777dd
--- /dev/null
+++ b/docs/migrations/how-to-upgrade-hermione-to-8.mdx
@@ -0,0 +1,98 @@
+import Admonition from "@theme/Admonition";
+
+# Как обновить hermione до версии 8.x
+
+<Admonition type="warning">
+Если в вашем проекте hermione младше 4-й версии, то прочтите сначала:
+* «[Как обновить hermione до версии 4.x][how-to-upgrade-hermione-to-4]»;
+* «[Как обновить hermione до версии 5.x][how-to-upgrade-hermione-to-5]»;
+* «[Как обновить hermione до версии 6.x][how-to-upgrade-hermione-to-6]»;
+* «[Как обновить hermione до версии 7.x][how-to-upgrade-hermione-to-7]».
+
+Мы рекомендуем вам обновлять hermione поэтапно, убеждаясь на каждом этапе, что все тесты проекта корректно выполняются.
+
+</Admonition>
+
+## Что изменилось? {#what_is_new}
+
+### Мажорные изменения {#major_changes}
+
+#### Изменились экспорты пакета {#package_exports_changed}
+
+Для использования hermione по API в javascript теперь необходимо подключать `hermione` следующим образом:
+
+```javascript
+const { default: hermione } = require("hermione");
+```
+
+Раньше можно было писать так:
+
+```javascript
+const hermione = require("hermione");
+```
+
+Вариант для typescript:
+
+```typescript
+import hermione from "hermione";
+```
+
+#### Изменена логика работы команды moveTo {#move_command_changed}
+
+Теперь команда `moveTo` смещает курсор не относительно левого верхнего угла, а относительно центра элемента. Если элемент не виден, то к нему будет выполнен подскрол.
+Раньше вызов команды без аргументов (`await browser.$('body).moveTo()`) смещал курсор в левый верхний угол элемента - теперь смещение произойдет в центр элемента.
+
+Если переходить на новую логику `moveTo` нет времени, то можете использовать команду `moveCursorTo`, которая работает как в hermione@7. Была добавлена в hermione@8.1.0.
+Команда `moveCursorTo` временная и будет удалена в следующем мажоре.
+
+#### Отказ от поддержки Node.JS < 18.x {#dropped_nodejs_less_than_18x}
+
+В этом мажоре hermione перестала поддерживать версии _Node.JS < 18.x_.
+
+### Минорные изменения {#minor_changes}
+
+-   реализован REPL-режим для пошагового дебага тестов во всех браузерах (не только CDP) без перезапуска;
+-   добавлена браузерная команда [clearSession][hermione-clear-session] для очистки состояния сессии:
+    -   удаляет файлы cookie;
+    -   очищает local storage;
+    -   очищает session storage.
+-   добавлена браузерная команда `openAndWait` с настраиваемым ожиданием загрузки (по селектору, кастомному предикату, сетевому запросу и т.д);
+-   добавлена cli-опция `--devtools` для упрощения переключения между двумя протоколами (`devtools` и `webdriver`);
+-   улучшен stack trace при ошибках `unhandled rejection`;
+-   теперь [изоляция][hermione-isolation] включена по умолчанию для chrome >= 94;
+-   во время выполнения команды [assertView][hermione-assert-view] CSS-анимации на странице будут отключены по умолчанию;
+-   реализовали генерацию уникального заголовка `X-Request-ID` для каждого запроса в браузер. Заголовок состоит из `${TEST_X_REQ_ID}${DELIMITER}$BROWSER_X_REQ_ID}`, где:
+
+    -   `TEST_X_REQ_ID` - уникальный uuid для каждого запуска теста (в том числе ретрая того же самого теста). Позволяет в логах найти все запросы, относящиеся к одному тестовому запуску;
+    -   `DELIMITER` - `__` разделитель между uuid-ами теста и запроса;
+    -   `BROWSER_X_REQ_ID` - уникальный uuid для каждого браузерного запроса.
+
+    Реальный пример uuid-а - `2f31ffb7-369d-41f4-bbb8-77744615d2eb__e8d011d8-bb76-42b9-b80e-02f03b8d6fe1`.
+
+### Патчевые изменения {#patch_changes}
+
+-   исправили отключение анимаций в айфреймах для ios при использовании [assertView][hermione-assert-view];
+-   избавились от реинициализации браузерной сессии в воркерах;
+-   исправили баг с невозможностью отключить [изоляцию][hermione-isolation].
+
+## Как переехать? {#how_to_move}
+
+### 1. Обновить hermione до 8+ и плагины до последних версий {#update_hermione_and_plugins}
+
+### 2. В случае использования hermione по API в javascript перейти на typescript или изменить require {#replace_hermione_require}
+
+### 3. В случае использования moveTo перейти на moveToCursor или указывать координаты от центра элемента {#replace_move_to}
+
+## Поддержка {#support}
+
+Если при переезде на новую версию вы столкнетесь с проблемами или у вас возникнут какие-либо вопросы, то приходите в [github issues][gh-issues] — и мы обязательно вам поможем!
+
+[how-to-upgrade-hermione-to-4]: ../migrations/how-to-upgrade-hermione-to-4
+[how-to-upgrade-hermione-to-5]: ../migrations/how-to-upgrade-hermione-to-5
+[how-to-upgrade-hermione-to-6]: ../migrations/how-to-upgrade-hermione-to-6
+[how-to-upgrade-hermione-to-7]: ../migrations/how-to-upgrade-hermione-to-7
+[prepare-browser]: ../config/prepare-browser
+[hermione-clear-session]: https://github.com/gemini-testing/hermione?tab=readme-ov-file#clearsession
+[hermione-isolation]: https://github.com/gemini-testing/hermione?tab=readme-ov-file#isolation
+[hermione-assert-view]: https://github.com/gemini-testing/hermione?tab=readme-ov-file#assertview
+[gh-issues]: https://github.com/gemini-testing/testplane/issues/
diff --git a/docs/plugins/hermione-browser-version-changer.mdx b/docs/plugins/hermione-browser-version-changer.mdx
new file mode 100644
index 0000000..8f654d3
--- /dev/null
+++ b/docs/plugins/hermione-browser-version-changer.mdx
@@ -0,0 +1,103 @@
+# hermione-browser-version-changer
+
+## Обзор {#overview}
+
+Используйте плагин [hermione-browser-version-changer][hermione-browser-version-changer], чтобы управлять определением версии браузера для тестов.
+
+## Установка {#install}
+
+```bash
+npm install -D hermione-browser-version-changer
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига Testplane:
+
+```javascript
+module.exports = {
+    plugins: {
+        "hermione-browser-version-changer": {
+            enabled: true,
+            initStore: async () => {
+                return {
+                    70.1: ["title1", "title2"],
+                    70.2: ["title3", "title4"],
+                };
+            },
+            browsers: {
+                chrome: {
+                    70.1: (test, ver, store) => store[ver].includes(test.title),
+                    70.2: (test, ver, store) => store[ver].includes(test.title),
+                },
+            },
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[enabled](#setup_enabled)</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>[initStore](#setup_init_store)</td><td>Function</td><td>_[noop][noop]_</td><td>Функция для инициализации хранилища _(store)_, которое будет доступно в [predicate](#setup_predicate).</td></tr>
+<tr><td>[browsers](#setup_browsers)</td><td>Object</td><td>_N/A_</td><td>Список браузеров и их настроек. См. [ниже](#setup_browsers) подробности.</td></tr>
+
+</tbody>
+</table>
+
+### enabled {#setup_enabled}
+
+Включить или отключить плагин. По умолчанию: `true`.
+
+### initStore {#setup_init_store}
+
+Необязательный параметр. Функция для инициализации хранилища _(store)_, которое будет доступно в [predicate](#setup_predicate). Хранилище может использоваться для того, чтобы потом в [predicate](#setup_predicate) для любого теста определить, какая версия браузера к нему относится. По умолчанию: [\_.noop][noop] из библиотеки `lodash`.
+
+Функция может быть асинхронной.
+
+### browsers {#setup_browsers}
+
+Список браузеров и их настроек. Имеет следующий формат:
+
+```javascript
+browsers: {
+    <browser-id>: {
+        <browser-version-1>: <predicate>,
+        <browser-version-2>: <predicate>,
+        // другие версии браузеров...
+    },
+    // другие браузеры...
+}
+```
+
+### predicate(test, version, store) {#setup_predicate}
+
+Функция-предикат, которая получает инстанс теста _(test),_ версию браузера _(version)_ и ссылку на хранилище _(store)_. Должна вернуть `true`, если тест подходит под указанную версию браузера, иначе должна вернуть `false`.
+
+### Передача параметров через CLI {#setup_by_cli}
+
+Все параметры плагина, которые можно определить в конфиге, можно также передать в виде опций командной строки или через переменные окружения во время запуска testplane. Используйте префикс `--browser-version-changer-` для опций командной строки и `testplane_browser_version_changer_` — для переменных окружения. Например:
+
+```bash
+npx testplane --browser-version-changer-enabled false ...
+```
+
+```bash
+testplane_browser_version_changer_enabled=false npx testplane ...
+```
+
+## Полезные ссылки {#useful_links}
+
+-   [Исходники плагина hermione-browser-version-changer][hermione-browser-version-changer]
+
+[hermione-browser-version-changer]: https://github.com/gemini-testing/hermione-browser-version-changer
+[noop]: https://lodash.com/docs/4.17.15#noop
diff --git a/docs/plugins/hermione-hide-scrollbars.mdx b/docs/plugins/hermione-hide-scrollbars.mdx
new file mode 100644
index 0000000..c85224a
--- /dev/null
+++ b/docs/plugins/hermione-hide-scrollbars.mdx
@@ -0,0 +1,73 @@
+import Admonition from "@theme/Admonition";
+
+# hermione-hide-scrollbars
+
+## Обзор {#overview}
+
+Используйте плагин [hermione-hide-scrollbars][hermione-hide-scrollbars], чтобы скрывать скроллбары в тестах, которые запускаются в Chrome-браузерах.
+
+Для получения доступа к браузеру через [Chrome DevTools Protocol (CDP)][CDP] плагин использует пакет [puppeteer-core](https://github.com/GoogleChrome/puppeteer).
+
+Чтобы скрывать скроллбары используется команда CDP [Emulation.setScrollbarsHidden][set-scrollbars-hidden].
+
+<Admonition type="warning">
+    Обновите Chrome-браузер до версии 72.1 и выше, чтобы данная функциональность работала в ваших
+    тестах. Так как более ранние версии Chrome-браузеров не поддерживают команду
+    _Emulation.setScrollbarsHidden_.
+</Admonition>
+
+## Установка {#install}
+
+```bash
+npm install -D hermione-hide-scrollbars
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+```javascript
+module.exports = {
+    plugins: {
+        "hermione-hide-scrollbars": {
+            enabled: true,
+            browsers: ["chrome"],
+            browserWSEndpoint: ({ sessionId, gridUrl }) =>
+                `ws://${url.parse(gridUrl).host}/devtools/${sessionId}`,
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>browsers</td><td>Array</td><td>`[ ]`</td><td>Список браузеров, для которых будет применена логика отключения скроллбаров.</td></tr>
+<tr><td>browserWSEndpoint</td><td>Function</td><td>_N/A_</td><td>Функция, которая должна вернуть URL для работы с браузером через [CDP][CDP]. Чтобы можно было вычислить URL, в функцию передаются идентификатор сессии и ссылка на грид: параметры передаются в виде объекта с ключами _sessionId и gridUrl_.</td></tr>
+
+</tbody>
+</table>
+
+### Передача параметров через CLI {#setup_by_cli}
+
+Все параметры плагина, которые можно определить в конфиге, можно также передать в виде опций командной строки или через переменные окружения во время запуска testplane. Используйте префикс `--hide-scrollbars-` для опций командной строки и `testplane_hide_scrollbars_` — для переменных окружения.
+
+## Полезные ссылки {#useful_links}
+
+-   [Исходники плагина hermione-hide-scrollbars][hermione-hide-scrollbars]
+-   [Emulation.setScrollbarsHidden][set-scrollbars-hidden]
+-   [createCDPSession](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.target.createcdpsession.md)
+-   [CDPSession class](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.cdpsession.md)
+
+[hermione-hide-scrollbars]: https://github.com/gemini-testing/hermione-hide-scrollbars/
+[set-scrollbars-hidden]: https://chromedevtools.github.io/devtools-protocol/tot/Emulation/#method-setScrollbarsHidden
+[CDP]: https://chromedevtools.github.io/devtools-protocol/
diff --git a/docs/plugins/hermione-reassert-view.mdx b/docs/plugins/hermione-reassert-view.mdx
new file mode 100644
index 0000000..9eddeab
--- /dev/null
+++ b/docs/plugins/hermione-reassert-view.mdx
@@ -0,0 +1 @@
+Плагин [hermione-reassert-view](https://github.com/gemini-testing/hermione-reassert-view/blob/master/README.md)
diff --git a/docs/plugins/html-reporter.mdx b/docs/plugins/html-reporter.mdx
new file mode 100644
index 0000000..ab070f8
--- /dev/null
+++ b/docs/plugins/html-reporter.mdx
@@ -0,0 +1,5 @@
+# html-reporter
+
+Про плагин `html-reporter` читайте в отдельном разделе «[Отчет testplane][html-reporter-setup]».
+
+[html-reporter-setup]: ../html-reporter/html-reporter-setup
diff --git a/docs/plugins/retry-limiter.mdx b/docs/plugins/retry-limiter.mdx
new file mode 100644
index 0000000..94166a3
--- /dev/null
+++ b/docs/plugins/retry-limiter.mdx
@@ -0,0 +1,109 @@
+import Admonition from "@theme/Admonition";
+
+# retry-limiter
+
+## Обзор {#overview}
+
+Используйте плагин [retry-limiter][retry-limiter], чтобы ограничивать количество ретраев упавших тестов, а также время, в течение которого ретраи разрешены.
+
+<Admonition type="tip">
+Используйте данный плагин при прогоне тестов в CI. — Так как в CI, как правило, прогоняются либо все тесты проекта, либо их значительная часть.
+
+Использовать плагин _retry-limiter_ при локальных запусках отдельных тестов чаще всего нецелесообразно, ввиду их малого количества и, соответственно, отсутствия значимого эффекта от экономии «железа» или времени на прогон тестов.
+
+</Admonition>
+
+Ретраи упавших тестов — один из способов борьбы с нестабильными тестами. Однако, бывают случаи, когда тесты падают массово из-за проблем с инфраструктурой или из-за того, что код проекта был сломан (например, в пулл-реквесте). В таких случаях ретраи только зря тратят ресурсы серверов, на которых прогоняются тесты, и время разработчика, заставляя разработчика ждать окончания прогона тестов, которые заведомо упадут.
+
+Чтобы избежать подобных сценариев, плагин `retry-limiter` позволяет:
+
+-   задать максимальную долю ретраев от общего количества тестов;
+-   ограничить время, в течение которого ретраи могут использоваться;
+-   снизить максимальное количество ретраев для всех тестов, если хотя бы один из тестов упадет, несмотря на все ретраи.
+
+Например, если в проекте запускаются 1000 тестов и для параметра `limit` в конфиге плагина установлено значение _0.3,_ то при падении тестов будет максимально разрешено _300_ ретраев.
+
+Если в конфиге плагина ещё установлено значение _600 секунд (10 минут)_ для параметра `timeLimit`, то независимо от того, сколько раз ещё можно ретраить упавшие тесты, плагин отключит механизм ретраев через _10 минут_ после начала прогона тестов. Последнее защищает от нерациональной траты ресурсов «железа» на слишком долгие прогоны тестов.
+
+Если testplane запущена с опцией `--retry`, например, со значением _7_, и при этом в конфиге плагина `retry-limiter` параметр `setRetriesOnTestFail` установлен в значение _4_, то это означает следующее: в случае падения хотя бы одного теста в любом из браузеров после _7_ ретраев, плагин посчитает, что возникла какая-то системная проблема и нужно снизить максимально разрешенное число ретраев до значения, заданного в параметре `setRetriesOnTestFail`, то есть до _4_. Это также позволяет защититься от нерационального расхода ресурсов на прогон тестов в случае системных проблем.
+
+<Admonition type="tip">
+    Если вы столкнулись в своем проекте с ситуацией, когда механизм ретраев начинает отключаться
+    из-за превышения _timeLimit_, то не рекомендуется бездумно увеличивать это время. Стоит
+    разобраться, почему прогон тестов начал выполняться слишком долго, а не «заливать железом»
+    реальную проблему со стабильностью прогонов тестов.
+</Admonition>
+
+## Установка {#install}
+
+```bash
+npm install -D retry-limiter
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+```javascript
+module.exports = {
+    plugins: {
+        "retry-limiter": {
+            limit: 0.3, // разрешаем не больше 30% ретраев от общего числа тестов
+            setRetriesOnTestFail: 4, // снижаем число ретраев до 4 после падения первого теста
+            timeLimit: 600, // через 10 минут ретраи должны быть отключены
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>limit</td><td>Number</td><td>1</td><td>Максимально разрешенная доля ретраев от общего количества тестов. Задается как число в диапазоне от 0 до 1. После превышения заданной доли ретраев ретраи будут отключены.</td></tr>
+<tr><td>setRetriesOnTestFail</td><td>Number</td><td>Infinity</td><td>Число ретраев, до которого надо снизить разрешенное число ретраев, если упадет хотя бы один тест, несмотря на все ретраи.</td></tr>
+<tr><td>timeLimit</td><td>Number</td><td>Infinity</td><td>Время в секундах, после истечения которого ретраи будут отключены.</td></tr>
+
+</tbody>
+</table>
+
+### Передача параметров через CLI {#setup_by_cli}
+
+Все параметры плагина, которые можно определить в конфиге, можно также передать в виде опций командной строки или через переменные окружения во время запуска testplane. Используйте префикс `--retry-limiter-` для опций командной строки и `retry_limiter_` — для переменных окружения. Например:
+
+```bash
+npx testplane --retry-limiter-time-limit=900 ...
+```
+
+```bash
+retry_limiter_time_limit=900 npx testplane ...
+```
+
+## Использование {#usage}
+
+При использовании плагина в логах testplane вы можете увидеть сообщения следующего вида:
+
+```bash
+retry-limiter: will stop retrying tests after 600 seconds
+```
+
+```bash
+retry-limiter: with limit 0.3 will stop retrying tests after 1189 retries
+```
+
+В первом сообщении плагин информирует об ограничении времени работы механизма ретраев.
+Во втором сообщении — об ограничении общего количества ретраев.
+
+## Полезные ссылки {#useful_links}
+
+-   [Исходники плагина retry-limiter][retry-limiter]
+
+[retry-limiter]: https://github.com/gemini-testing/retry-limiter
diff --git a/docs/plugins/stat-reporter.mdx b/docs/plugins/stat-reporter.mdx
new file mode 100644
index 0000000..945c1f6
--- /dev/null
+++ b/docs/plugins/stat-reporter.mdx
@@ -0,0 +1,196 @@
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+import Admonition from "@theme/Admonition";
+
+# stat-reporter
+
+## Обзор {#overview}
+
+Используйте плагин [stat-reporter][stat-reporter], чтобы получить отчет(ы) со статистикой прогона тестов в [testplane][testplane].
+
+Плагин позволяет получать отчет как в консоли, так и в виде html- и/или json-файла. При этом отчеты не взаимоисключающие: после прогона тестов можно получить сразу 3 вида отчетов.
+
+### Формат отчета {#report_format}
+
+В отчете плагина результаты прогона тестов разбиты по браузерам. Также выводятся максимальное время выполнения _(Duration)_ в минутах и секундах и результат прогона тестов _(Status)_ в каждом браузере. Такой отчет позволяет понять в каких браузерах возникли проблемы, а именно: не проходит больше всего тестов или время выполнения резко возросло.
+
+По умолчанию включен только отчет в консоли:
+
+```bash
+┌──────────────────────┬────────┬───────┬────────┬────────┬─────────┬─────────┬──────────┐
+│ Browser              │ Status │ Tests │ Passed │ Failed │ Skipped │ Retries │ Duration │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ firefox              │ passed │ 25    │ 24     │ 0      │ 1       │ 0       │ 01:02    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-desktop       │ passed │ 466   │ 464    │ 0      │ 2       │ 4       │ 07:40    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ ipad                 │ passed │ 24    │ 23     │ 0      │ 1       │ 0       │ 01:27    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ iphone               │ passed │ 376   │ 372    │ 0      │ 4       │ 7       │ 07:12    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-phone         │ passed │ 427   │ 421    │ 0      │ 6       │ 14      │ 07:32    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ iphone-dark          │ passed │ 74    │ 72     │ 0      │ 2       │ 4       │ 02:18    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ searchapp-phone      │ passed │ 319   │ 317    │ 0      │ 2       │ 9       │ 10:00    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ safari13             │ passed │ 15    │ 13     │ 0      │ 2       │ 4       │ 02:42    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-desktop-1920  │ passed │ 3     │ 3      │ 0      │ 0       │ 0       │ 00:57    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ iphoneX              │ passed │ 3     │ 3      │ 0      │ 0       │ 0       │ 00:36    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-desktop-dark  │ passed │ 77    │ 77     │ 0      │ 0       │ 5       │ 01:33    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ yandex-browser-phone │ passed │ 1     │ 1      │ 0      │ 0       │ 0       │ 00:28    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-grid-720      │ passed │ 2     │ 2      │ 0      │ 0       │ 0       │ 00:49    │
+└──────────────────────┴────────┴───────┴────────┴────────┴─────────┴─────────┴──────────┘
+```
+
+<Admonition type="info">
+    Если вы хотите получить больше функциональности, то используйте [html-reporter][html-reporter]
+    для получения отчета о прогоне тестов.
+</Admonition>
+
+## Установка {#install}
+
+```bash
+npm install -D stat-reporter
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+<Tabs>
+<TabItem value="Минимальный конфиг" label="Минимальный конфиг">
+```javascript
+    module.exports = {
+        plugins: {
+            'stat-reporter': {
+                enabled: true
+                // отчет будет только в консоли
+            },
+
+            // другие плагины testplane...
+        },
+
+        // другие настройки testplane...
+    };
+    ```
+
+</TabItem>
+
+<TabItem value="Максимальный конфиг" label="Максимальный конфиг">
+```javascript
+    module.exports = {
+        plugins: {
+            'stat-reporter': {
+                enabled: true,
+                reporters: {
+                    flat: {
+                        enabled: true
+                    },
+                    html: {
+                        enabled: true,
+                        path: 'some/path/to/file.html'
+                        // если не указывать path, то отчет будет сохранен
+                        // в stat-reporter.html в текущей рабочей директории
+                    },
+                    json: {
+                        enabled: true,
+                        path: 'some/path/to/file.json'
+                        // если не указывать path, то отчет будет сохранен
+                        // в stat-reporter.json в текущей рабочей директории
+                    }
+                }
+            },
+
+            // другие плагины testplane...
+        },
+
+        // другие настройки testplane...
+    };
+    ```
+
+</TabItem>
+
+</Tabs>
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[enabled](#setup_enabled)</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>[reporters](#setup_reporters)</td><td>Object</td><td>_см. описание_</td><td>Настройки отчетов со статистикой прогона тестов. По умолчанию включен только отчет в консоли _(flat)_.</td></tr>
+
+</tbody>
+</table>
+
+### enabled {#setup_enabled}
+
+Включить или отключить плагин. По умолчанию: `true`.
+
+### reporters {#setup_reporters}
+
+Необязательный параметр. Задает настройки отчетов со статистикой прогона тестов.
+
+По умолчанию:
+
+```javascript
+{
+    // отчет со статистикой будет только в консоли
+    flat: {
+        enabled: true;
+    }
+}
+```
+
+Параметр является объектом, в котором ключ определяет тип отчета, а его значение в виде объекта — соответствующие настройки отчета. Можно задать следующие ключи:
+
+-   _flat_ — для отчета в консоли;
+-   _html_ — для html-отчета;
+-   _json_ — для json-отчета.
+
+Все отчеты имеют в настройках параметр `enabled` типа `Boolean`, который определяет включен отчет или отключен. По умолчанию включен только отчет в консоли.
+
+Также отчеты типа `html` и `json` имеют дополнительный параметр `path` — путь к файлу, в который необходимо сохранить отчет.
+
+По умолчанию отчет сохраняется в текущей рабочей директории в файл `stat-reporter.html` или `stat-reporter.json` в зависимости от типа отчета.
+
+### Передача параметров через CLI {#setup_by_cli}
+
+Все параметры плагина, которые можно определить в конфиге, можно также передать в виде опций командной строки или через переменные окружения во время запуска testplane. Используйте префикс `--stat-reporter-` для опций командной строки и `stat_reporter_` — для переменных окружения. Например:
+
+```bash
+npx testplane --stat-reporter-reporters-html-enabled=true
+```
+
+```bash
+stat_reporter_reporters_html_enabled = true npx testplane
+```
+
+## Команды плагина {#commands}
+
+### merge-stat-reports {#commands_merge_stat_reports}
+
+Плагин добавляет к testplane команду `merge-stat-reports`, с помощью которой можно объединить несколько отчетов в один общий отчет как в html, так и в json-формате. При этом команда позволяет получить на выходе итоговые отчеты сразу в двух форматах.
+
+Для сохранения итогового отчета в требуемом формате нужно указать соответствующую опцию: `--html` или `--json`.
+
+```bash
+npx testplane merge-stat-reports src-report-1.json src-report-2.json --html dest-html-report --json report.json
+```
+
+## Полезные ссылки {#useful_links}
+
+-   [Исходники плагина stat-reporter][stat-reporter]
+
+[stat-reporter]: https://github.com/gemini-testing/stat-reporter
+[html-reporter]: ../html-reporter/html-reporter-setup
+[testplane]: https://github.com/gemini-testing/testplane
diff --git a/docs/plugins/testplane-chunks.mdx b/docs/plugins/testplane-chunks.mdx
new file mode 100644
index 0000000..cfe03fb
--- /dev/null
+++ b/docs/plugins/testplane-chunks.mdx
@@ -0,0 +1,113 @@
+import Admonition from "@theme/Admonition";
+
+# testplane-chunks
+
+## Обзор {#overview}
+
+Используйте плагин [testplane-chunks][testplane-chunks], чтобы распараллелить запуск тестов.
+
+Если в вашем проекте большое количество тестов и при этом не хватает мощности отдельных CI-серверов, чтобы выполнить все эти тесты на одном сервере за приемлемое время, то этот плагин — для вас.
+
+Плагин позволяет распараллелить запуск тестов на нескольких серверах. Тем самым ускорив общий прогон тестов. Однако сам плагин не занимается какой-либо оркестрацией, распараллеливанием запуска или слиянием получившихся отдельных отчетов в один итоговый отчет.
+
+### Что же тогда делает данный плагин? {#what_does_plugin_do}
+
+Плагин `testplane-chunks` разбивает **всегда одним и тем же способом** ваш набор тестов на заданное количество порций _(chunks)_ и отдает testplane на запуск только ту порцию, которую вы указали. Здесь ключевое — _«всегда одним и тем же способом»_. То есть операция разбиения на порции (чанки) является [идемпотентной][idempotence].
+
+### Что дает идемпотентность? {#what_does_idempotence_give}
+
+Вы можете организовать в своем CI переиспользование результатов запусков тестов из отдельных чанков при общем перезапуске. Это позволит вам сэкономить время при перезапуске всех тестов, так как прогоняться будут только те чанки, в которых есть упавшие тесты.
+
+Например, в вашем проекте есть 1 тысяча тестов. Вы разбили эти тесты на 10 чанков по 100 тестов в каждом. Это означает, что при запуске тестов в вашем пулл-реквесте, у вас будет 10 инстансов testplane, запущенных одновременно на 10 серверах. Каждый инстанс выполнит по 100 тестов. В каких-то из этих запусков тесты могут упасть. Например, 2 из 10 чанков у вас упали. Вы решаете перезапустить прогон тестов, рассчитывая, что на этот раз тесты пройдут. Так вот, при перезапуске testplane с указанием номера упавшего чанка, вы можете быть абсолютно уверены, что плагин `testplane-chunks` сформирует для testplane точно такую же порцию тестов как и в прошлый свой запуск.
+
+<Admonition type="warning">
+    Организуя перезапуск тестов в своем CI, помните, что для **переиспользования** запусков
+    отдельных чанков, исходное количество тестов, их имена, или количество браузеров, в которых они
+    запускаются, не должны меняться между запусками. Иначе чанки в новом запуске уже не будут такими
+    же, как в прошлый раз. И хотя формально вы получите то же количество чанков, что и в прошлый
+    раз, их содержимое при этом будет отличаться. А значит переиспользование прошлых результатов
+    окажется некорректным.
+</Admonition>
+
+### Во сколько раз ускорятся мои тесты? {#how_much_will_tests_speed_up}
+
+Нужно понимать, что ускорение возможно только за счет того, что тесты будут запускаться на большем количестве железа.
+
+Если у вас нет в наличии серверов, которые можно было бы выделить под параллельный запуск сразу нескольких testplane, то разбивать тесты на соответствующее количество чанков смысла нет. Если CI будет ждать освобождения какого-либо сервера, чтобы запустить очередную порцию тестов, то ваш параллельный запуск превратится в последовательный, и никакого ускорения вы не получите. Даже наоборот — произойдет замедление из-за накладных расходов на отдельные запуски testplane и формирование итогового отчета.
+
+То есть параллельность — количество чанков, на которые вы разбиваете свои тесты — обязательно должна быть обеспечена соответствующим количеством доступного железа.
+
+### А как получить итоговый отчет? {#how_to_get_report}
+
+Добавьте в свой проект плагин [html-reporter][html-reporter].
+
+Используйте команду [merge-reports][merge-reports], которую [html-reporter][html-reporter] добавляет к [CLI][cli] testplane, чтобы слить все получившиеся в отдельных чанках отчеты в один итоговый отчет.
+
+## Установка {#install}
+
+```bash
+npm install -D testplane-chunks
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-chunks": {
+            count: 7, // Разбить тесты на 7 порций (чанков)
+            run: 1, // Запустить первую порцию
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+<Admonition type="info">
+    Можно не задавать параметр _run_ — в конфиге плагина, так как при параллельных запусках
+    testplane для каждого запуска вы будете указывать свой номер порции _(run)_. И этот номер нужно
+    будет передавать либо через опцию командной строки, либо через переменную окружения (см.
+    [передачу параметров через CLI](#setup_by_cli)).
+</Admonition>
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>count</td><td>Number</td><td>1</td><td>Количество порций (чанков), на которые нужно разбить набор тестов.</td></tr>
+<tr><td>run</td><td>Number</td><td>1</td><td>Номер чанка, тесты из которого нужно запустить.</td></tr>
+
+</tbody>
+</table>
+
+### Передача параметров через CLI {#setup_by_cli}
+
+Все параметры плагина, которые можно определить в конфиге, можно также передать в виде опций командной строки или через переменные окружения во время запуска testplane. Используйте префикс `--chunks-` для опций командной строки и `testplane_chunks_` — для переменных окружения. Например:
+
+```bash
+npx testplane --chunks-count 10 --chunks-run 1 ...
+```
+
+```bash
+testplane_chunks_count=10 testplane_chunks_run=1 npx testplane ...
+```
+
+## Полезные ссылки {#useful_links}
+
+-   [Исходники плагина testplane-chunks][testplane-chunks]
+-   [Что такое идемпотентность?][idempotence]
+
+[html-reporter]: ../html-reporter/html-reporter-setup
+[merge-reports]: ../html-reporter/html-reporter-commands#merge_reports
+[testplane-chunks]: https://github.com/gemini-testing/testplane-chunks
+[cli]: https://ru.wikipedia.org/wiki/Интерфейс_командной_строки
+[idempotence]: https://ru.wikipedia.org/wiki/Идемпотентность
diff --git a/docs/plugins/testplane-global-hook.mdx b/docs/plugins/testplane-global-hook.mdx
new file mode 100644
index 0000000..ed40a6a
--- /dev/null
+++ b/docs/plugins/testplane-global-hook.mdx
@@ -0,0 +1,73 @@
+# testplane-global-hook
+
+## Обзор {#overview}
+
+Используйте плагин [testplane-global-hook][testplane-global-hook], чтобы вынести общую логику из своих тестов в специальные обработчки для `beforeEach` и `afterEach` хуков.
+
+Часто, перед тем как запустить очередной testplane-тест, нужно выполнить определенную подготовительную работу, например:
+
+-   очистить все cookies;
+-   почистить localStorage;
+-   инициализировать какую-либо переменную теста.
+
+Чтобы не прописывать эти действия в каждом тесте, вы можете описать их в настройках плагина в виде функции для хука `beforeEach`.
+
+Аналогично, после завершения основных проверок в testplane-тесте, вы можете захотеть всегда проверять наличие ошибок в клиентском коде, срабатывание нужных метрик и т. п.
+
+Чтобы не прописывать эти действия в каждом тесте, вы можете описать их в настройках плагина в виде функции для хука `afterEach`.
+
+## Установка {#install}
+
+```bash
+npm install -D testplane-global-hook
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-global-hook": {
+            beforeEach: async function () {
+                await this.browser.deleteCookie(); // Например, мы хотим всегда очищать cookies перед запуском теста
+            },
+            afterEach: async function () {
+                await this.browser.execute(function () {
+                    try {
+                        localStorage.clear(); // И всегда очищать за собой localStorage после завершения теста
+                    } catch (e) {}
+                });
+            },
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>beforeEach</td><td>Function</td><td>null</td><td>Асинхронная функция-обработчик, которая будет выполняться перед запуском каждого теста.</td></tr>
+<tr><td>afterEach</td><td>Function</td><td>null</td><td>Асинхронная функция-обработчик, которая будет выполняться после завершения каждого теста.</td></tr>
+
+</tbody>
+</table>
+
+## Полезные ссылки {#useful_links}
+
+-   [Исходники плагина testplane-global-hook][testplane-global-hook]
+-   [Команда browser.deleteCookie](../commands/browser/deleteCookies)
+-   [Команда browser.execute](../commands/browser/execute)
+-   [Команда browser.executeAsync](../commands/browser/executeAsync)
+
+[testplane-global-hook]: https://github.com/gemini-testing/testplane-global-hook
diff --git a/docs/plugins/testplane-image-minifier.mdx b/docs/plugins/testplane-image-minifier.mdx
new file mode 100644
index 0000000..5dffbc5
--- /dev/null
+++ b/docs/plugins/testplane-image-minifier.mdx
@@ -0,0 +1,114 @@
+import Admonition from "@theme/Admonition";
+
+# testplane-image-minifier
+
+## Обзор {#overview}
+
+Используйте плагин [testplane-image-minifier][testplane-image-minifier], чтобы сжимать изображения (скриншоты) в своих тестах.
+
+Плагин поддерживает 8 степеней сжатия: от 0 (не применять сжатие) до 7 (максимальная степень сжатия).
+
+Сжатие происходит без потерь.
+
+### Как это работает? {#how_does_it_work}
+
+При запуске плагин подписывается на событие `UPDATE_REFERENCE`, которое testplane посылает в случаях:
+
+-   если пользователь запустил testplane, передав ей опцию `--update-refs`;
+-   если пользователь обновляет или сохраняет скриншоты с помощью плагина [html-reporter][html-reporter].
+
+Когда в плагин `testplane-image-minifier` прилетает событие `UPDATE_REFERENCE`, он получает вместе с событием ссылку на само изображение. Далее плагин применяет к полученному изображению алгоритм сжатия с указанной в конфиге степенью сжатия. И сохраняет новое изображение на файловую систему. После этого разработчик может влить обновленные файлы в главную ветку своего проекта.
+
+Для сжатия изображений плагин `testplane-image-minifier` использует пакет [optipng-bin][optipng-bin].
+
+<Admonition type="info">
+    Выбирая степень сжатия для изображений в своем проекте, помните, что вы выбираете между
+    скоростью и местом, которое будут занимать ваши изображения на диске. Чем выше степень сжатия,
+    тем меньше места будут занимать ваши изображения на диске, но дольше будут выполняться сами
+    тесты. Так как перед тем как сравнивать изображения в тестах система должна будет их
+    распаковать. Поэтому, чтобы получить приемлемое время прогона тестов, соизмеряйте выбираемую
+    степень сжатия с мощностью серверов, на которых эти тесты будут выполняться.
+</Admonition>
+
+## Установка {#install}
+
+```bash
+npm install -D testplane-image-minifier
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-image-minifier": {
+            enabled: true, // Включить плагин.
+            compressionLevel: 7, // Максимальный уровень компрессии, сжатие займет какое-то время
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>compressionLevel</td><td>Number</td><td>2</td><td>Степень сжатия изображения: от 0 до 7 (максимальная степень сжатия).</td></tr>
+
+</tbody>
+</table>
+
+### Передача параметров через CLI {#setup_by_cli}
+
+Все параметры плагина, которые можно определить в конфиге, можно также передать в виде опций командной строки или через переменные окружения во время запуска testplane. Используйте префикс `--image-minifier-` для опций командной строки и `testplane_image_minifier_` — для переменных окружения. Например:
+
+```bash
+npx testplane --image-minifier-compression-level 5 ...
+```
+
+```bash
+testplane_image_minifier_compression_level = 5 npx testplane ...
+```
+
+## Отладка {#debugging}
+
+Установите переменную окружения `DEBUG=testplane:image-minifier`, чтобы видеть сообщения о применении алгоритма сжатия для изображений в тестах.
+
+```bash
+DEBUG=testplane:image-minifier npx testplane --update-refs
+```
+
+Пример, как это будет выглядеть в консоли:
+
+```bash
+/path/to/reference/image.png compressed by 30%
+```
+
+## Использование {#usage}
+
+После добавления плагина в проект и настройки его параметров запустите testplane с опцией `--update-refs`:
+
+```bash
+npx testplane --update-refs
+```
+
+Изображения на файловой системе будут обновлены.
+
+## Полезные ссылки {#useful_links}
+
+-   [Исходники плагина testplane-image-minifier][testplane-image-minifier]
+-   [Пакет для сжатия изображений optipng-bin][optipng-bin]
+
+[testplane-image-minifier]: https://github.com/gemini-testing/testplane-image-minifier/
+[html-reporter]: ../plugins/html-reporter
+[optipng-bin]: https://www.npmjs.com/package/optipng-bin
diff --git a/docs/plugins/testplane-passive-browsers.mdx b/docs/plugins/testplane-passive-browsers.mdx
new file mode 100644
index 0000000..b79de0d
--- /dev/null
+++ b/docs/plugins/testplane-passive-browsers.mdx
@@ -0,0 +1 @@
+Плагин [testplane-passive-browsers](https://github.com/gemini-testing/testplane-passive-browsers/blob/master/README.md)
diff --git a/docs/plugins/testplane-plugins-profiler.mdx b/docs/plugins/testplane-plugins-profiler.mdx
new file mode 100644
index 0000000..b1f7f86
--- /dev/null
+++ b/docs/plugins/testplane-plugins-profiler.mdx
@@ -0,0 +1 @@
+Плагин [testplane-plugins-profiler](https://github.com/gemini-testing/testplane-plugins-profiler/blob/master/README.md)
diff --git a/docs/plugins/testplane-retry-command.mdx b/docs/plugins/testplane-retry-command.mdx
new file mode 100644
index 0000000..4d30cc3
--- /dev/null
+++ b/docs/plugins/testplane-retry-command.mdx
@@ -0,0 +1,122 @@
+import Admonition from "@theme/Admonition";
+
+# testplane-retry-command
+
+## Обзор {#overview}
+
+Используйте плагин [testplane-retry-command][testplane-retry-command], чтобы ретраить отдельные команды на низком уровне.
+
+## Установка {#install}
+
+```bash
+npm install -D testplane-retry-command
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-retry-command": {
+            enabled: true,
+            rules: [
+                {
+                    condition: "blank-screenshot",
+                    browsers: ["MicrosoftEdge"],
+                    retryCount: 5,
+                    retryInterval: 120,
+                },
+                {
+                    condition: "assert-view-failed",
+                    browsers: ["Chrome"],
+                    retryCount: 1,
+                    retryOnlyFirst: true,
+                },
+            ],
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody> 
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>rules</td><td>Array</td><td>_N/A_</td><td>Набор правил, в соответствии с которыми команды будут ретраиться. Обязательный параметр.</td></tr>
+
+</tbody>
+</table>
+
+### rules {#setup_rules}
+
+Параметр `rules` представляет собой массив объектов. Каждый объект описывает отдельное правило для ретрая команд.
+
+Из каких параметров состоит это правило:
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody> 
+<tr><td>[condition](#setup_rules_condition)</td><td>String</td><td>_N/A_</td><td>Условие для ретрая: _blank-screenshot_ или _assert-view-failed_. Подробнее см. ниже.</td></tr>
+<tr><td>[browsers](#setup_rules_browsers)</td><td>String/RegExp/Array</td><td>/.*/</td><td>Список браузеров, в которых нужно применять ретраи.</td></tr>
+<tr><td>[retryCount](#setup_rules_retry_count)</td><td>Number</td><td>2</td><td>Количество ретраев.</td></tr>
+<tr><td>[retryInterval](#setup_rules_retry_interval)</td><td>Number</td><td>100</td><td>Задержка перед каждым ретраем, в мс.</td></tr>
+<tr><td>[retryOnlyFirst](#setup_rules_retry_only_first)</td><td>Boolean</td><td>false</td><td>Ретраить только первую команду в тесте. Опция актуальна только для условия _assert-view-failed_.</td></tr>
+
+</tbody>
+</table>
+
+### condition {#setup_rules_condition}
+
+Условие, при котором нужно ретраить. Всего доступны 2 значения:
+
+-   `blank-screenshot` — ретраить низкоуровневую команду снятия скриншота [takeScreenshot][take-screenshot], если в результате команды вернулся пустой скриншот;
+-   `assert-view-failed` — ретраить высокоуровневую команду testplane для снятия скриншота [assertView][assert-view], если она упала.
+
+### browsers {#setup_rules_browsers}
+
+Список браузеров, в которых нужно применять низкоуровневые ретраи для команд. Можно задавать как строку (если это один браузер), регулярное выражение или массив строк или регулярных выражений. По умолчанию, параметр `browsers` имеет значение `/.*/`, под которое попадают все браузеры.
+
+### retryCount {#setup_rules_retry_count}
+
+Параметр определяет сколько раз нужно ретраить команду, если соблюдено условие, заданное в параметре `condition`.
+
+### retryInterval {#setup_rules_retry_interval}
+
+Параметр задает время в миллисекундах, которое надо подождать, прежде чем попытаться снова повторить команду.
+
+<Admonition type="warning">
+    Будьте осторожны, устанавливая значение для данного параметра, так как слишком большое значение
+    может драматически снизить скорость ваших тестов.
+</Admonition>
+
+### retryOnlyFirst {#setup_rules_retry_only_first}
+
+Разрешает ретраить только первую команду [assertView][assert-view] в тесте, если установлено значение `true`. Для других условий этот параметр не используется.
+
+### Передача параметров через CLI {#setup_by_cli}
+
+Все параметры плагина, которые можно определить в конфиге, можно также передать в виде опций командной строки или через переменные окружения во время запуска testplane. Используйте префикс `--retry-command-` для опций командной строки и `testplane_retry_command_` — для переменных окружения. Например:
+
+```bash
+npx testplane --retry-command-count 3
+```
+
+```bash
+testplane_retry_command_count=3 npx testplane
+```
+
+[testplane-retry-command]: https://github.com/gemini-testing/testplane-retry-command
+[take-screenshot]: https://webdriver.io/docs/api/webdriver/#takescreenshot
+[assert-view]: ../commands/browser/assertView
diff --git a/docs/plugins/testplane-retry-progressive.mdx b/docs/plugins/testplane-retry-progressive.mdx
new file mode 100644
index 0000000..70fbded
--- /dev/null
+++ b/docs/plugins/testplane-retry-progressive.mdx
@@ -0,0 +1,119 @@
+# testplane-retry-progressive
+
+## Обзор {#overview}
+
+Используйте плагин [testplane-retry-progressive][testplane-retry-progressive], чтобы дополнительно прогонять тесты, если ошибки, с которыми они упали соответствуют заданному набору шаблонов.
+
+Для чего это может понадобиться?
+
+Тесты могут падать не только из-за ошибок разработчика, гонок между скриптами, исполняющимися на веб-странице, но и по инфраструктурным причинам. Например, когда моргает сеть, вовремя не отдается браузер, временные проблемы с DNS и т. п.
+
+<details>
+
+<summary>
+См. примеры шаблонов для таких ошибок
+
+</summary>
+
+-   Browser request was cancelled
+-   A window size operation failed because the window is not currently available
+-   chrome not reachable
+-   Tried to run command without establishing a connection
+-   No such driver
+-   no such window
+-   Session timed out or not found
+-   Reached error page
+-   getaddrinfo ENOTFOUND
+-   Browsing context has been discarded
+-   Cannot launch browser
+-   Failed to decode response from marionette
+-   session deleted because of page crash
+-   Couldn't connect to selenium server
+
+</details>
+
+## Установка {#install}
+
+```bash
+npm install -D testplane-retry-progressive
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-retry-progressive": {
+            enabled: true,
+            extraRetry: 7,
+            errorPatterns: [
+                "Parameter .* must be a string",
+                {
+                    name: "Cannot read property of undefined",
+                    pattern: "Cannot read property .* of undefined",
+                },
+            ],
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>extraRetry</td><td>Number</td><td>5</td><td>Количество раз, которые нужно повторно прогнать тест, если он падает с ошибкой, подходящей под один из шаблонов _errorPatterns_.</td></tr>
+<tr><td>errorPatterns</td><td>Array</td><td>`[ ]`</td><td>Список шаблонов, под один из которых должна подойти ошибка, чтобы плагин запустил тест повторно. Подробнее см. ниже.</td></tr>
+
+</tbody>
+</table>
+
+### errorPatterns {#setup_error_patterns}
+
+Каждый шаблон в массиве `errorPatterns` представляет собой либо объект вида:
+
+```javascript
+{
+    name: 'Понятное сообщение для пользователя, которое будет выводиться в консоль',
+    pattern: 'Шаблон ошибки, который может задаваться в том числе как строка для регулярного выражения'
+}
+```
+
+либо строку, которая будет проинтерпретирована плагином как объект вида:
+
+```javascript
+{
+    name: 'ваша строка',
+    pattern: 'ваша строка'
+}
+```
+
+Последний вариант удобен, если формат для консоли и шаблон ошибки полностью совпадают.
+
+### Передача параметров через CLI {#setup_by_cli}
+
+Все параметры плагина, которые можно определить в конфиге, можно также передать в виде опций командной строки или через переменные окружения во время запуска testplane. Используйте префикс `--retry-progressive-` для опций командной строки и `testplane_retry_progressive_` — для переменных окружения. Например:
+
+```bash
+npx testplane --retry-progressive-extra-retry 3 ...
+```
+
+```bash
+testplane_retry_progressive_extra_retry=3 npx testplane ...
+```
+
+## Полезные ссылки {#useful_links}
+
+-   [Исходники плагина testplane-retry-progressive][testplane-retry-progressive]
+
+[testplane-retry-progressive]: https://github.com/gemini-testing/testplane-retry-progressive
diff --git a/docs/plugins/testplane-tabs-closer.mdx b/docs/plugins/testplane-tabs-closer.mdx
new file mode 100644
index 0000000..c93a0d9
--- /dev/null
+++ b/docs/plugins/testplane-tabs-closer.mdx
@@ -0,0 +1 @@
+Плагин [testplane-tabs-closer](https://github.com/gemini-testing/testplane-tabs-closer/blob/master/README.md)
diff --git a/docs/plugins/testplane-test-filter.mdx b/docs/plugins/testplane-test-filter.mdx
new file mode 100644
index 0000000..64af2ae
--- /dev/null
+++ b/docs/plugins/testplane-test-filter.mdx
@@ -0,0 +1 @@
+Плагин [testplane-test-filter](https://github.com/gemini-testing/testplane-test-filter/blob/master/README.md)
diff --git a/docs/plugins/testplane-test-repeater.mdx b/docs/plugins/testplane-test-repeater.mdx
new file mode 100644
index 0000000..d76de34
--- /dev/null
+++ b/docs/plugins/testplane-test-repeater.mdx
@@ -0,0 +1,82 @@
+# testplane-test-repeater
+
+## Обзор {#overview}
+
+Используйте плагин [testplane-test-repeater][testplane-test-repeater], чтобы запустить один и тот же тест (или группу тестов) требуемое количество раз.
+
+Данный плагин может пригодиться в тех случаях, когда нужно убедиться в стабильности написанных тестов. Плагин гарантирует, что тесты будут запущены столько раз, сколько вы задали, независимо от результатов их прогона в каждой попытке. Кроме того, плагин позволяет запускать тесты каждый раз в новой сессии браузера. Это исключает влияние деградации браузера или еще какие-либо побочные эффекты, которые могли бы возникнуть при повторных прогонах в одной и той же сессии браузера.
+
+## Установка {#install}
+
+```bash
+npm install -D testplane-test-repeater
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-test-repeater": {
+            enabled: true,
+            repeat: 50,
+            minRepeat: 10,
+            maxRepeat: 100,
+            uniqSession: true,
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>repeat</td><td>Number</td><td>0</td><td>Сколько раз нужно запустить тест, независимо от результата от его прогона.</td></tr>
+<tr><td>minRepeat</td><td>Number</td><td>0</td><td>Минимальное количество раз, которые можно запустить тест.</td></tr>
+<tr><td>maxRepeat</td><td>Number</td><td>Infinity</td><td>Максимальное количество раз, которые можно запустить тест.</td></tr>
+<tr><td>uniqSession</td><td>Boolean</td><td>true</td><td>Запускать каждый тест в уникальной сессии браузера.</td></tr>
+
+</tbody>
+</table>
+
+### Передача параметров через CLI {#setup_by_cli}
+
+Все параметры плагина, которые можно определить в конфиге, можно также передать в виде опций командной строки или через переменные окружения во время запуска testplane. Используйте префикс `--test-repeater-` для опций командной строки и `testplane_test_repeater_` — для переменных окружения. Например:
+
+```bash
+npx testplane --test-repeater-repeat 5 ...
+```
+
+```bash
+testplane_test_repeater_repeat=5 npx testplane ...
+```
+
+## Использование {#usage}
+
+### Опция --repeat {#usage_option_repeat}
+
+Также плагин добавляет к [CLI][cli] testplane специальную опцию `--repeat`, с помощью которой можно запустить тест нужное количество раз более удобным образом. Например:
+
+```bash
+npx testplane --repeat 5
+```
+
+[cli]: https://ru.wikipedia.org/wiki/Интерфейс_командной_строки
+
+## Полезные ссылки {#useful_links}
+
+-   [Исходники плагина testplane-test-repeater][testplane-test-repeater]
+
+[testplane-test-repeater]: https://github.com/gemini-testing/testplane-test-repeater
+[cli]: https://ru.wikipedia.org/wiki/Интерфейс_командной_строки
diff --git a/docs/plugins/url-decorator.mdx b/docs/plugins/url-decorator.mdx
new file mode 100644
index 0000000..eb3dc9c
--- /dev/null
+++ b/docs/plugins/url-decorator.mdx
@@ -0,0 +1,329 @@
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+import Admonition from "@theme/Admonition";
+
+# url-decorator
+
+## Обзор {#overview}
+
+Используйте плагин [url-decorator][url-decorator], чтобы автоматически дополнять урлы в testplane-тестах нужными query-параметрами.
+
+## Установка {#install}
+
+```bash
+npm install -D url-decorator
+```
+
+## Настройка {#setup}
+
+Необходимо подключить плагин в разделе `plugins` конфига `testplane`:
+
+```javascript
+module.exports = {
+    plugins: {
+        "url-decorator": {
+            enabled: true,
+            url: {
+                query: [
+                    {
+                        name: "text",
+                        value: "foo",
+                    },
+
+                    // другие query-параметры...
+                ],
+            },
+        },
+
+        // другие плагины testplane...
+    },
+
+    // другие настройки testplane...
+};
+```
+
+### Расшифровка параметров конфигурации {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[enabled](#setup_enabled)</td><td>Boolean</td><td>true</td><td>Включить / отключить плагин.</td></tr>
+<tr><td>[url](#setup_url)</td><td>Object</td><td>_N/A_</td><td>Объект с описанием query-параметров, которые должны добавляться к каждому урлу в тесте.</td></tr>
+
+</tbody>
+</table>
+
+### enabled {#setup_enabled}
+
+Включить или отключить плагин. По умолчанию: `true`.
+
+### url {#setup_url}
+
+Параметр `url` представляет собой объект с полем `query`, значением которого может быть как массив, так и объект.
+
+<Tabs>
+<TabItem value="query как массив" label="query как массив">
+```javascript
+    module.exports = {
+        plugins: {
+            'url-decorator': {
+                enabled: true,
+                url: {
+                    query: [
+                        {
+                            name: '<param-1>', // укажите имя query-параметра
+                            value: '<param-1-value>', // укажите значение query-параметра
+                            mode: 'concat', // или 'override'
+                            browsers: /.*/ // по умолчанию: для всех браузеров
+                        },
+                        {
+                            name: '<param-2>', // укажите имя query-параметра
+                            value: '<param-2-value>', // укажите значение query-параметра
+                            mode: 'concat', // или 'override'
+                            browsers: /.*/ // по умолчанию: для всех браузеров
+                        },
+
+                        // остальные query-параметры...
+                    ]
+                }
+            },
+
+            // другие плагины testplane...
+        },
+
+        // другие настройки testplane...
+    };
+    ```
+
+</TabItem>
+
+<TabItem value="query как объект" label="query как объект">
+```javascript
+    module.exports = {
+        plugins: {
+            'url-decorator': {
+                enabled: true,
+                url: {
+                    query: {
+                        '<param-1>': { // укажите имя query-параметра
+                            value: '<param-1-value>', // укажите значение query-параметра
+                            mode: 'concat', // или 'override'
+                            browsers: /.*/ // по умолчанию: для всех браузеров
+                        },
+                        '<param-2>': { // укажите имя query-параметра
+                            value: '<param-2-value>', // укажите значение query-параметра
+                            mode: 'concat', // или 'override'
+                            browsers: /.*/ // по умолчанию: для всех браузеров
+                        },
+
+                        // остальные query-параметры...
+                    }
+                },
+            },
+
+            // другие плагины testplane...
+        },
+
+        // другие настройки testplane...
+    };
+    ```
+
+</TabItem>
+
+</Tabs>
+
+Здесь query-параметр — это объект со следующими полями:
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**По&nbsp;умолчанию**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[name](#setup_query_param_name)</td><td>String</td><td>_N/A_</td><td>Имя query-параметра. Если _query_ задается как объект, то это поле не указывается, так как сам ключ является именем query-параметра.</td></tr>
+<tr><td>[value](#setup_query_param_value)</td><td>String или Number или Array</td><td>_N/A_</td><td>Значение query-параметра.</td></tr>
+<tr><td>[mode](#setup_query_param_mode)</td><td>String</td><td>"concat"</td><td>Режим объединения параметров: _concat_ или _override_.</td></tr>
+<tr><td>[browsers](#setup_query_param_browsers)</td><td>String или RegExp или Array</td><td>_N/A_</td><td>Список браузеров, к которым будет применен query-параметр.</td></tr>
+
+</tbody>
+</table>
+
+#### name {#setup_query_param_name}
+
+Имя query-параметра. Если `query` задается как объект, то это поле не указывается, так как сам ключ является именем query-параметра.
+
+#### value {#setup_query_param_value}
+
+Значение query-параметра. Может задаваться как строка, число или массив строк и/или чисел.
+
+#### mode {#setup_query_param_mode}
+
+Режим объединения параметров. Возможны 2 значения: `concat` _(склеивать параметры)_ и `override` _(перетирать параметры)_. По умолчанию: `concat`.
+
+**Режим concat**
+
+Например:
+
+-   вы хотите добавить query-параметр `nick`, который уже есть в урле вашего теста `http://localhost/test/?nick=bilbo`;
+-   при этом вы не хотите, чтобы дополнительное значение параметра `nick` перетерло то значение, что уже есть в урле.
+
+В этом случае вам нужно указать для параметра `mode: 'concat'` или вообще не указывать `mode` (воспользовавшись режимом по умолчанию):
+
+```javascript
+url: {
+    query: [
+        {
+            name: "nick",
+            value: "torin",
+            mode: "concat", // или можно вообще не указывать mode, так как по умолчанию mode = 'concat'
+        },
+    ];
+}
+```
+
+Тогда результирующим урлом в тесте будет: `http://localhost/test/?nick=bilbo&nick=torin`.
+
+Также вы можете указать в значении `value` массив значений для параметра `nick`:
+
+```javascript
+url: {
+    query: [
+        {
+            name: "nick",
+            value: ["torin", "gloin"],
+            mode: "concat", // или можно вообще не указывать mode, так как по умолчанию mode = 'concat'
+        },
+    ];
+}
+```
+
+Тогда результирующим урлом в тесте будет: `http://localhost/test/?nick=bilbo&nick=torin&nick=gloin`.
+
+**Режим override**
+
+Если же вы хотите перетереть параметр `nick`, то нужно установить режим `override`:
+
+```javascript
+url: {
+    query: [
+        {
+            name: "nick",
+            value: "torin",
+            mode: "override",
+        },
+    ];
+}
+```
+
+Тогда результирующим урлом в тесте будет: `http://localhost/test/?nick=torin`.
+
+#### browsers {#setup_query_param_browsers}
+
+Браузер или список браузеров, или паттерн регулярного выражения для браузеров, к которым нужно применять заданные query-параметры. Если параметр `browsers` не указан, то query-параметры будут применяться для всех браузеров.
+
+Ниже приведены примеры задания параметра `browsers` всеми способами:
+
+<Tabs>
+<TabItem value="строка" label="строка">
+```javascript
+    url: {
+        query: [
+            {
+                name: 'nick',
+                value: 'gloin',
+                browsers: 'firefox'
+            }
+        ]
+    }
+    ```
+</TabItem>
+
+<TabItem value="массив строк" label="массив строк">
+```javascript
+    url: {
+        query: [
+            {
+                name: 'nick',
+                value: 'gloin',
+                browsers: ['firefox', 'chrome']
+            }
+        ]
+    }
+    ```
+</TabItem>
+
+<TabItem value="regexp" label="regexp">
+```javascript
+    url: {
+        query: [
+            {
+                name: 'nick',
+                value: 'gloin',
+                browsers: /ie-\d+/  //ie-8, ie-9, ie-10, ...
+            }
+        ]
+    }
+    ```
+</TabItem>
+
+<TabItem value="массив regexp / строк" label="массив regexp / строк">
+```javascript
+    url: {
+        query: [
+            {
+                name: 'nick',
+                value: 'gloin',
+                browsers: [/ie-\d+/, 'firefox']
+            }
+        ]
+    }
+    ```
+</TabItem>
+
+</Tabs>
+
+### Передача параметров через CLI {#setup_by_cli}
+
+#### HERMIONE*URL_QUERY*\*
+
+Чтобы передать дополнительные query-параметры, можно воспользоваться переменными окружения следующего вида:
+
+```bash
+HERMIONE_URL_QUERY_&lt;имя query-параметра>
+```
+
+Например, в вашем тесте открывается урл `http://localhost/test/?tool=testplane`, а вы хотите добавить к урлу query-параметр `text` со значением `ololo` с помощью переменной окружения:
+
+```bash
+HERMIONE_URL_QUERY_TEXT=ololo testplane ...
+```
+
+После этого в вашем тесте будет открываться урл вида: `http://localhost/test/?tool=testplane&text=ololo`.
+
+#### HERMIONE_URL_CUSTOM_QUERIES
+
+Если среди ваших query-параметров есть параметры, которые нельзя выразить в виде переменной окружения (например, `foo-bar`), то вы можете добавить эти параметры через переменную окружения `HERMIONE_URL_CUSTOM_QUERIES`.
+
+В качестве значения используйте строку вида `<query-param-1>=<value-1>;<query-param-2>=<value-2>;`.
+
+Например:
+
+```bash
+HERMIONE_URL_CUSTOM_QUERIES='foo-bar=baz;qux=1' testplane ...
+```
+
+Тогда в вашем тесте будет открываться урл вида: `http://localhost/test/?foo-bar=baz&qux=1`.
+
+<Admonition type="warning">
+    Переменные окружения имеют более высокий приоритет, чем значения соответствующих переменных в
+    конфиге плагина.
+</Admonition>
+
+## Полезные ссылки {#useful_links}
+
+-   [Исходники плагина url-decorator][url-decorator]
+
+[url-decorator]: https://github.com/gemini-testing/url-decorator
+[internal-url-decorator]: ../plugins/internal-url-decorator
diff --git a/docs/quickstart/index.mdx b/docs/quickstart/index.mdx
new file mode 100644
index 0000000..956127b
--- /dev/null
+++ b/docs/quickstart/index.mdx
@@ -0,0 +1,106 @@
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+# Быстрый старт
+
+Прежде всего, убедитесь, что ваша система удовлетворяет нужным требованиям.
+
+## Установка {#install}
+
+Запустите установщик testplane с помощью `npm`.
+
+```bash
+npm init testplane@latest YOUR_PROJECT_PATH
+```
+
+Если вы не хотите использовать дефолты при инициализации проекта, а настроить его с помощью визарда, укажите опцию `-v`.
+
+## Настройка {#setup}
+
+После выполнения команды, указанной выше, в корне проекта сгенерится файл `.testplane.conf.js` с базовой настройкой. В зависимости от того, каким протоколом вы хотите воспользоваться, есть 2 варианта настройки (по умолчанию для браузера будет указан протокол CDP).
+
+<Tabs>
+<TabItem value="Chrome Devtools Protocol" label="Chrome Devtools Protocol">
+```javascript
+  module.exports = {
+      sets: {
+          desktop: {
+              files: 'tests/desktop'
+          }
+      },
+
+      browsers: {
+          chrome: {
+              automationProtocol: 'devtools',
+              desiredCapabilities: {
+                  browserName: 'chrome'
+              }
+          }
+      }
+
+};
+
+````
+</TabItem>
+
+
+<TabItem value="WebDriver protocol" label="WebDriver protocol">
+```javascript
+module.exports = {
+    gridUrl: 'http://localhost:4444/wd/hub',
+
+    sets: {
+        desktop: {
+            files: 'tests/desktop'
+        }
+    },
+
+    browsers: {
+        chrome: {
+            automationProtocol: 'webdriver', // default value
+            desiredCapabilities: {
+                browserName: 'chrome'
+            }
+        }
+    }
+};
+````
+
+</TabItem>
+
+</Tabs>
+
+## Создание теста {#test_creation}
+
+Перейдите в файл `tests/example.testplane.js` с тестом. В нем вы можете посмотреть пример теста или написать свой. Например,
+
+```javascript
+describe("github", async function () {
+    it("should find testplane", async function ({ browser }) {
+        await browser.url("https://github.com/gemini-testing/testplane");
+        const elem = await browser.$("#readme h1");
+
+        await expect(elem).toHaveText("Testplane");
+    });
+});
+```
+
+## Запуск теста {#test_running}
+
+Теперь вы можете запустить тесты:
+
+```bash
+npx testplane
+```
+
+или запустить gui-режим и запустить тест через интерфейс в браузере
+
+```bash
+npx testplane gui
+```
+
+Если при настройке конфига вы выбрали `WebDriver protocol`, то перед запуском тестов у вас должен быть запущен (в отдельной вкладке) `selenium-standalone`:
+
+```bash
+selenium-standalone start
+```
diff --git a/docs/reference/hermione-api.mdx b/docs/reference/hermione-api.mdx
new file mode 100644
index 0000000..13ad483
--- /dev/null
+++ b/docs/reference/hermione-api.mdx
@@ -0,0 +1,550 @@
+# API testplane
+
+С помощью API testplane вы можете использовать её в своих скриптах или сборочных инструментах.
+
+Для этого вы должны подключить модуль testplane и создать её инстанс:
+
+```javascript
+const Testplane = require("testplane");
+
+const config = require("./testplane.conf.js");
+
+const testplane = new Testplane(config);
+```
+
+Далее вам будут доступны следующие параметры и методы:
+
+<table>
+<thead>
+<tr><td>**Имя**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>[config](#testplane_config)</td><td>Object или String</td><td>Объект с конфигом testplane или путь к конфигурационному файлу, относительно рабочей папки.</td></tr>
+<tr><td>[events](#testplane_events)</td><td>Object</td><td>[События testplane][testplane-events], на которые можно подписаться.</td></tr>
+<tr><td>[errors](#testplane_errors)</td><td>Object</td><td>Ошибки, которые может возвращать testplane.</td></tr>
+<tr><td>[intercept](#testplane_intercept)</td><td>Function</td><td>Функция, с помощью которой можно подписаться на [перехват событий][testplane-events-interception] testplane.</td></tr>
+<tr><td>[init](#testplane_init)</td><td>Method</td><td>Инициализирует инстанс testplane, загружает все плагины и т. д.</td></tr>
+<tr><td>[run](#testplane_run)</td><td>Method</td><td>Запускает прогон тестов, расположенных по указанным путям.</td></tr>
+<tr><td>[addTestToRun](#testplane_add_test_to_run)</td><td>Method</td><td>Добавляет тест к текущему запуску.</td></tr>
+<tr><td>[readTests](#testplane_read_tests)</td><td>Method</td><td>Возвращает объект типа [TestCollection](#test_collection).</td></tr>
+<tr><td>[isFailed](#testplane_is_failed)</td><td>Method</td><td>Возвращает `true` или `false` в зависимости от того, была ли ошибка или падение теста при запуске тестов.</td></tr>
+<tr><td>[isWorker](#testplane_is_worker)</td><td>Method</td><td>Возвращает `true`, если метод был вызван из воркера testplane.</td></tr>
+<tr><td>[halt](#testplane_halt)</td><td>Method</td><td>Аварийно завершает прогон тестов в случае критической ошибки.</td></tr>
+
+</tbody>
+</table>
+
+## config {#testplane_config}
+
+Объект с конфигом testplane или путь к конфигурационному файлу, относительно рабочей папки: `process.cwd()`.
+
+## events {#testplane_events}
+
+[События testplane][testplane-events], на которые можно подписаться.
+
+Пример использования объекта `testplane.events` в плагине testplane:
+
+```javascript
+testplane.on(testplane.events.INIT, async () => {
+    console.info("Выполняется обработка события INIT...");
+});
+```
+
+## errors {#testplane_errors}
+
+Testplane может возвращать ошибки следующего типа:
+
+-   [CoreError](#testplane_errors_core_error)
+-   [CancelledError](#testplane_errors_cancelled_error)
+-   [ClientBridgeError](#testplane_errors_client_bridge_error)
+-   [HeightViewportError](#testplane_errors_height_viewport_error)
+-   [OffsetViewportError](#testplane_errors_offset_viewport_error)
+-   [AssertViewError](#testplane_errors_assert_view_error)
+-   [ImageDiffError](#testplane_errors_image_diff_error)
+-   [NoRefImageError](#testplane_errors_no_ref_image_error)
+
+### CoreError {#testplane_errors_core_error}
+
+Ошибка `CoreError` возвращается в случае неудачной калибровки пустой страницы (`about:blank`) в браузере.
+
+Ошибка при этом содержит следующее сообщение:
+
+```
+Could not calibrate. This could be due to calibration page has failed to open properly
+```
+
+### CancelledError {#testplane_errors_cancelled_error}
+
+Ошибка `CancelledEror` возвращается в случае аварийного завершения по команде [halt](#testplane_halt).
+
+Ошибка при этом содержит следующее сообщение:
+
+```
+Browser request was cancelled
+```
+
+### ClientBridgeError {#testplane_errors_client_bridge_error}
+
+Ошибка `ClientBridgeError` возвращается в случае неудачной инъекции кода JavaScript на стороне клиента (браузера). Testplane осуществляет инъекцию кода с помощью команды [execute][wdio-execute] WebDriverIO.
+
+Ошибка при этом содержит следующее сообщение:
+
+```
+Unable to inject client script
+```
+
+### HeightViewportError {#testplane_errors_height_viewport_error}
+
+Ошибка `HeightViewportError` возвращается при попытке снять скриншот для области, чья нижняя граница не влезает в область вьюпорта.
+
+Ошибка при этом содержит следующее сообщение:
+
+```
+Can not capture the specified region of the viewport.
+The region bottom bound is outside of the viewport height.
+Alternatively, you can test such cases by setting "true" value to option "compositeImage" in the config file
+or setting "false" to "compositeImage" and "true" to option "allowViewportOverflow" in "assertView" command.
+Element position: <cropArea.left>, <cropArea.top>; size: <cropArea.width>, <cropArea.height>.
+Viewport size: <viewport.width>, <viewport.height>.
+```
+
+При этом сообщение подсказывает пользователю testplane, какие настройки нужно установить в конфиге testplane, чтобы иметь возможность снять скриншот для указанной области.
+
+### OffsetViewportError {#testplane_errors_offset_viewport_error}
+
+Ошибка `OffsetViewportError` возвращается при попытке снять скриншот для области, чьи границы слева, справа или наверху выходят за пределы вьюпорта.
+
+Ошибка при этом содержит следующее сообщение:
+
+```
+Can not capture the specified region of the viewport.
+Position of the region is outside of the viewport left, top or right bounds.
+Check that elements:
+- does not overflow the document
+- does not overflow browser viewport
+Alternatively, you can increase browser window size using
+"setWindowSize" or "windowSize" option in the config file.
+But if viewport overflow is expected behavior then you can use
+option "allowViewportOverflow" in "assertView" command.
+```
+
+При этом сообщение подсказывает пользователю testplane, какие настройки нужно установить в конфиге testplane, чтобы иметь возможность снять скриншот для указанной области.
+
+### AssertViewError {#testplane_errors_assert_view_error}
+
+Ошибка `AssertViewError` возвращается при неудачной попытке снять скриншот.
+
+Ошибка при этом может содержать одно из следующих сообщений, в зависимости от причины падения:
+
+```
+duplicate name for "<state>" state
+```
+
+```
+element ("<selector>") still not existing after <this.options.waitforTimeout> ms
+```
+
+```
+element ("<this.selector>") still not existing after <this.options.waitforTimeout> ms
+```
+
+### ImageDiffError {#testplane_errors_image_diff_error}
+
+Ошибка `ImageDiffError` возвращается из команды `assertView`, если при снятии и сравнении скриншота с эталонным скриншотом обнаруживается дифф (разница в изображениях).
+
+Ошибка при этом содержит следующее сообщение:
+
+```
+images are different for "<stateName>" state
+```
+
+Кроме этого, ошибка `ImageDiffError` содержит следующие данные:
+
+<table>
+<thead>
+<tr><td>**Свойство**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>stateName</td><td>имя состояния, для которого делался скриншот</td></tr>
+<tr><td>currImg</td><td>ссылка на актуальное изображение</td></tr>
+<tr><td>refImg</td><td>ссылка на эталонное изображение</td></tr>
+<tr><td>diffOpts</td><td>настройки определения диффа</td></tr>
+<tr><td>diffBounds</td><td>границы областей с диффами на изображении</td></tr>
+<tr><td>diffClusters</td><td>кластеры с диффами на изображении</td></tr>
+
+</tbody>
+</table>
+
+Подробнее про [diffBounds][diff-bounds] и [diffClusters][diff-clusters] читайте в документации пакета [looks-same][looks-same].
+
+```
+exports.handleImageDiff = (currImg, refImg, state, opts) => {
+    const {tolerance, antialiasingTolerance, canHaveCaret, diffAreas, config} = opts;
+    const {buildDiffOpts, system: {diffColor}} = config;
+    buildDiffOpts.ignoreCaret = buildDiffOpts.ignoreCaret && canHaveCaret;
+
+    const diffOpts = {
+        current: currImg.path, reference: refImg.path,
+        diffColor, tolerance, antialiasingTolerance, ...buildDiffOpts
+    };
+
+    return Promise.reject(ImageDiffError.create(state, currImg, refImg, diffOpts, diffAreas));
+};
+```
+
+### NoRefImageError {#testplane_errors_no_ref_image_error}
+
+Ошибка `NoRefImageError` возвращается из команды `assertView`, если при снятии и сравнении скриншота testplane не находит эталонный скриншот на файловой системе.
+
+Ошибка при этом содержит следующее сообщение:
+
+```
+can not find reference image at <refImg.path> for "<stateName>" state
+```
+
+Кроме этого, ошибка `NoRefImageError` содержит следующие данные:
+
+<table>
+<thead>
+<tr><td>**Свойство**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>stateName</td><td>имя состояния, для которого делался скриншот</td></tr>
+<tr><td>currImg</td><td>ссылка на актуальное изображение</td></tr>
+<tr><td>refImg</td><td>ссылка на эталонное изображение</td></tr>
+
+</tbody>
+</table>
+
+## intercept {#testplane_intercept}
+
+Функция, с помощью которой можно подписаться на [перехват событий][testplane-events-interception] testplane.
+
+Первым аргументом функция принимает событие, которое нужно перехватывать, а вторым — обработчик события.
+
+Например:
+
+```javascript
+testplane.intercept(testplane.events.TEST_FAIL, ({ event, data }) => {
+    return {};
+});
+```
+
+Подробнее о перехвате событий читайте в разделе «[Про перехват событий][testplane-events-interception]».
+
+## init {#testplane_init}
+
+Инициализирует инстанс testplane, загружает все плагины и т. д.
+
+### Пример вызова
+
+```javascript
+await testplane.init();
+```
+
+## run {#testplane_run}
+
+Запускает прогон тестов, расположенных по заданным путям.
+
+Возвращает `true`, если прогон тестов завершился успешно, и `false` — если не успешно.
+
+### Пример вызова
+
+```javascript
+const success = await testplane.run(testPaths, options);
+```
+
+### Параметры вызова
+
+Все параметры метода `testplane.run()` являются необязательными.
+
+<table>
+<thead>
+<tr><td>**Имя&nbsp;параметра**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>testPaths</td><td>String[] или TestCollection</td><td>Пути к тестам относительно рабочей папки _(process.cwd())_ или объект типа _TestCollection_, который возвращается методом _readTests_. Если пути не указаны, то будут запущены все тесты.</td></tr>
+<tr><td>options</td><td>Object</td><td>Объект с опциями запуска.</td></tr>
+<tr><td>options.reporters</td><td>String[]</td><td>Репортеры для результатов прогона тестов.</td></tr>
+<tr><td>options.browsers</td><td>String[]</td><td>Браузеры, в которых нужно запустить тесты.</td></tr>
+<tr><td>options.sets</td><td>String[]</td><td>Сеты, в которых нужно запустить тесты.</td></tr>
+<tr><td>options.grep</td><td>RegExp</td><td>Шаблон регулярного выражения, который задает тесты для запуска.</td></tr>
+
+</tbody>
+</table>
+
+## addTestToRun {#testplane_add_test_to_run}
+
+Добавляет тест к текущему запуску. Возвращает `false`, если текущий запуск уже закончился или был отменен. Иначе возвращает `true`.
+
+### Пример вызова
+
+```javascript
+const success = testplane.addTestToRun(test, browser);
+```
+
+### Параметры вызова
+
+Все параметры являются обязательными.
+
+<table>
+<thead>
+<tr><td>**Имя&nbsp;параметра**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>test</td><td>Test</td><td>Тест для запуска.</td></tr>
+<tr><td>browserId</td><td>String</td><td>Браузер, в котором нужно запустить тест.</td></tr>
+
+</tbody>
+</table>
+
+## readTests {#testplane_read_tests}
+
+Асинхронный метод. Возвращает объект типа [TestCollection](#test_collection).
+
+### Пример вызова
+
+```javascript
+await testplane.readTests(testPaths, options);
+```
+
+### Параметры вызова
+
+<table>
+<thead>
+<tr><td>**Имя&nbsp;параметра**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>testPaths</td><td>String[]</td><td>Пути к тестам относительно рабочей папки _(process.cwd())_.</td></tr>
+<tr><td>options</td><td>Object</td><td>Объект с настройками режима чтения тестов.</td></tr>
+<tr><td>options.browsers</td><td>String[]</td><td>Прочитать тесты только для указанных браузеров.</td></tr>
+<tr><td>options.silent</td><td>Boolean</td><td>Отключить генерацию событий во время чтения тестов. По умолчанию: _false_.</td></tr>
+<tr><td>options.ignore</td><td>String или Glob или String[] или Glob[]</td><td>Шаблоны, указывающие какие пути на файловой системе надо исключить при поиске тестов.</td></tr>
+<tr><td>options.sets</td><td>String[]</td><td>Сеты, в которых нужно прочитать тесты.</td></tr>
+<tr><td>options.grep</td><td>RegExp</td><td>Шаблон регулярного выражения, который задает тесты для чтения.</td></tr>
+
+</tbody>
+</table>
+
+## isFailed {#testplane_is_failed}
+
+Возвращает `true` или `false` в зависимости от того, была ли ошибка или падение теста при запуске тестов. Может пригодиться в плагинах для того, чтобы определить текущий статус testplane.
+
+### Пример вызова
+
+```javascript
+const failed = testplane.isFailed();
+```
+
+## isWorker {#testplane_is_worker}
+
+Возвращает `true`, если метод был вызван из воркера testplane.
+Возвращает `false`, если метод был вызван из мастер-процесса testplane.
+
+Может пригодиться в плагинах для того, чтобы различать контекст выполнения кода.
+
+### Пример вызова
+
+```javascript
+// реализация какого-либо плагина
+module.exports = testplane => {
+    if (testplane.isWorker()) {
+        // этот код будет выполняться только в воркерах testplane
+    } else {
+        // этот код будет выполняться только в мастер-процессе testplane
+    }
+};
+```
+
+## halt {#testplane_halt}
+
+Аварийно завершает прогон тестов в случае критической ошибки. Если процессу не удается корректно завершить работу за заданное контрольное время _(timeout)_, то он будет принудительно завершен, кроме случаев, когда _timeout_ явно установлен в `0`.
+
+### Пример вызова
+
+```javascript
+testplane.halt(error, [timeout=60000ms]);
+```
+
+### Параметры вызова
+
+<table>
+<thead>
+<tr><td>**Имя&nbsp;параметра**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>error</td><td>Error</td><td>Возникшая критическая ошибка, из-за которой приходится останавливать testplane.</td></tr>
+<tr><td>timeout</td><td>Number</td><td>Необязательный параметр. Контрольное время завершения процесса testplane. По умолчанию: _60000 мс_.</td></tr>
+
+</tbody>
+</table>
+
+## Test Collection {#test_collection}
+
+Объект типа `TestCollection` возвращается методом [testplane.readTests](#testplane_read_tests), а также передается в качестве аргумента в обработчик события [AFTER_TESTS_READ][after-tests-read].
+
+### getBrowsers {#test_collection_get_browsers}
+
+Возвращает список браузеров, для которых в коллекции есть тесты.
+
+#### Пример вызова
+
+```javascript
+const browsers = testCollection.getBrowsers();
+```
+
+### mapTests {#test_collection_map_tests}
+
+Строит отображение тестов для заданного браузера.
+
+#### Пример вызова
+
+```javascript
+const tests = testCollection.mapTests(browserId, (test, browserId) => {
+    // ...
+});
+```
+
+Если браузер не задан (то есть первым аргументом передан обратный вызов), то будет строиться отображение тестов для всех браузеров.
+
+### sortTests {#test_collection_sort_tests}
+
+Сортирует тесты для заданного браузера.
+
+#### Пример вызова
+
+```javascript
+testCollection.sortTests(browserId, (currentTest, nextTest) => {
+    // ...
+});
+```
+
+Если браузер не задан (то есть первым аргументом передан обратный вызов), то сортировка будет применена ко всем браузерам.
+
+### eachTest {#test_collection_each_test}
+
+Выполняет итерацию по тестам для заданного браузера.
+
+#### Пример вызова
+
+```javascript
+testCollection.eachTest(browserId, (test, browserId) => {
+    // ...
+});
+```
+
+Если браузер не задан (то есть первым аргументом передан обратный вызов), то итерация будет происходить по тестам для всех браузеров.
+
+### eachTestByVersions {#test_collection_each_test_by_versions}
+
+Выполняет итерацию по тестам и версиям браузера для заданного браузера.
+
+Использует наличие у каждого теста свойства `browserVersion`.
+
+#### Пример вызова
+
+```javascript
+testCollection.eachTestByVersions(browserId, (test, browserId, browserVersion) => {
+    // ...
+});
+```
+
+### disableAll {#test_collection_disable_all}
+
+Отключает все тесты или тесты для заданного браузера. Возвращает ссылку на инстанс коллекции тестов.
+
+#### Примеры вызова
+
+```javascript
+disableAll();
+```
+
+или
+
+```javascript
+disableAll(browserId);
+```
+
+Если браузер не задан, то будут отключены все тесты.
+
+### enableAll {#test_collection_enable_all}
+
+Включает все тесты или тесты для заданного браузера. Возвращает ссылку на инстанс коллекции тестов.
+
+#### Примеры вызова
+
+```javascript
+enableAll();
+```
+
+или
+
+```javascript
+enableAll(browserId);
+```
+
+Если браузер не задан, то будут включены все тесты.
+
+### disableTest {#test_collection_disable_test}
+
+Отключает указанный тест во всех браузерах или только в заданном браузере. Возвращает ссылку на инстанс коллекции тестов.
+
+#### Примеры вызова
+
+```javascript
+disableTest(fullTitle);
+```
+
+или
+
+```javascript
+disableTest(fullTitle, browserId);
+```
+
+Идентификатором теста является его полное название: `fullTitle`.
+
+### enableTest {#test_collection_enable_test}
+
+Включает указанный тест во всех браузерах или только в заданном браузере. Возвращает ссылку на инстанс коллекции тестов.
+
+#### Примеры вызова
+
+```javascript
+enableTest(fullTitle);
+```
+
+или
+
+```javascript
+enableTest(fullTitle, browserId);
+```
+
+### getRootSuite {#test_collection_get_root_suite}
+
+Возвращает корневой suite для заданного браузера. Возвращает `undefined`, если в коллекции нет тестов для указанного браузера.
+
+#### Пример вызова
+
+```javascript
+const rootSuite = getRootSuite(browserId);
+```
+
+### eachRootSuite {#test_collection_each_root_suite}
+
+Выполняет итерацию по всем корневым suite в коллекции, в которых есть тесты.
+
+#### Пример вызова
+
+```javascript
+eachRootSuite((root, browserId) => {
+    // ...
+});
+```
+
+[after-tests-read]: ./testplane-events#after_tests_read
+[testplane-events]: ./testplane-events.nd
+[wdio-execute]: ../commands/browser/execute
+[diff-bounds]: https://github.com/gemini-testing/looks-same/blob/master/README.md#getting-diff-bounds
+[diff-clusters]: https://github.com/gemini-testing/looks-same/blob/master/README.md#getting-diff-clusters
+[looks-same]: https://github.com/gemini-testing/looks-same
+[testplane-events-interception]: ./testplane-events#events_interception
diff --git a/docs/reference/testplane-events.mdx b/docs/reference/testplane-events.mdx
new file mode 100644
index 0000000..b357646
--- /dev/null
+++ b/docs/reference/testplane-events.mdx
@@ -0,0 +1,1817 @@
+import Admonition from "@theme/Admonition";
+
+# События testplane
+
+## Обзор {#overview}
+
+### Как устроено описание событий {#how_is_events_description_made}
+
+Ниже описаны все события testplane, на которые можно подписаться в своем плагине.
+
+Описание каждого события начинается с тегов, которые представлены следующими вариантами:
+
+-   _sync_ или _async_ обозначают, соответственно, синхронный и асинхронный режимы вызова обработчика события;
+-   _master_ обозначает, что данное событие доступно из мастер-процесса testplane;
+-   _worker_ обозначает, что данное событие доступно из воркеров (подпроцессов) testplane;
+-   _can be intercepted_ обозначает, что данное событие можно перехватить и соответственно, изменить.
+
+Далее идут:
+
+-   описание обстоятельств, при которых триггерится событие;
+-   сниппет с кодом, показывающим как на него подписаться;
+-   параметры обработчика события;
+-   и опционально, примеры использования данного события в плагине или плагинах.
+
+### Схема генерации событий {#events_scheme}
+
+[//]: # "<style>"
+[//]: # '.yc-root_theme_light img[src*="-dark-mode"] { display: none }'
+[//]: # '.yc-root_theme_dark img[src*="-light-mode"] { display: none }'
+[//]: # "</style>"
+
+![Генерация testplane-событий](/img/docs/reference/testplane-events-light-mode.png)
+
+[//]: # "![Генерация testplane-событий](/img/docs/reference/testplane-events-dark-mode.png)"
+
+### Описание последовательности событий {#events_scheme_description}
+
+Testplane можно запускать как через [CLI (командную строку)][cli-wiki], так и через её API: из скрипта с помощью команды [run][testplane-run].
+
+После запуска testplane загружает все плагины и переходит к парсингу CLI, если она была запущена через CLI, или сразу к стадии инициализации, если её запустили через API.
+
+#### Парсинг CLI
+
+Если testplane была запущена через CLI, то она триггерит событие [CLI](#cli). Любой плагин может подписаться на это событие, чтобы добавить свои опции и команды к testplane до того, как testplane распарсит CLI.
+
+Если testplane была запущена с помощью API, то стадия парсинга CLI будет пропущена и сразу же начнется стадия инициализации.
+
+#### Инициализация
+
+Во время инициализации testplane триггерит событие [INIT](#init). Это событие срабатывает всего 1 раз за весь запуск testplane. Подписавшись на это событие, плагины могут выполнить всю необходимую им подготовительную работу: открыть и прочитать какие-то файлы, поднять dev-сервер, инициализировать структуры данных, и т. д. и т. п.
+
+Затем testplane запускает подпроцессы (так называемые воркеры), в рамках которых будут выполняться все тесты. В мастер-процессе testplane тесты не выполняются, а только осуществляется общая оркестрация всего процесса запуска тестов, включая генерацию событий при завершении выполнения отдельных тестов.
+
+Количество воркеров, которые запускает testplane, регулируется параметром [workers][system-workers] в разделе [system][system] конфига testplane. При запуске очередного воркера testplane триггерит специальное событие [NEW_WORKER_PROCESS](#new_worker_process).
+
+<Admonition type="info">
+    Все тесты testplane запускает в воркерах, чтобы не столкнуться с ограничениями по памяти и CPU
+    для мастер-процесса. Как только в воркере количество выполненных тестов достигнет значения
+    [testsPerWorker][system-tests-per-worker], воркер завершит свою работу, и будет запущен новый
+    воркер. Соответственно, будет снова послано событие [NEW_WORKER_PROCESS](#new_worker_process).
+</Admonition>
+
+#### Чтение тестов
+
+После этого testplane читает все тесты с файловой системы в мастер-процессе. Посылая для каждого файла, перед тем как его прочитать, событие [BEFORE_FILE_READ](#before_file_read) и после прочтения — событие [AFTER_FILE_READ](#after_file_read).
+
+После того, как все тесты будут прочитаны, триггерится событие [AFTER_TESTS_READ](#after_tests_read).
+
+#### Запуск тестов
+
+Затем testplane посылает события [RUNNER_START](#runner_start) и [BEGIN](#begin). И стартует новую сессию (браузерную сессию), в которой будут выполняться тесты. При старте сессии testplane триггерит событие [SESSION_START](#session_start).
+
+<Admonition type="info">
+Если количество тестов, выполненных в рамках одной сессии, достигнет значения параметра [testsPerSession][browser-tests-per-session], то testplane завершит сессию, стриггерив событие [SESSION_END](#session_end), и запустит новую, послав событие [SESSION_START](#session_start).
+
+Если тест при выполнении упадет с критической ошибкой, то testplane:
+
+-   досрочно удалит сессию и браузер, который с ней связан;
+-   создаст новую сессию;
+-   запросит новый браузер, и привяжет его к новой сессии.
+
+Это нужно для того, чтобы сбой в сессии при выполнении одного из тестов не начал влиять на запуски последующих тестов.
+
+</Admonition>
+
+После создания новой сессии testplane переходит к выполнению тестов. Все тесты выполняются в воркерах, но сам запуск и сбор результатов прогона тестов осуществляется в рамках мастер-процесса. Мастер-процесс триггерит событие [SUITE_BEGIN](#suite_begin) для describe-блоков в файле с тестами и [TEST_BEGIN](#test_begin) для it-блоков. Если тест отключен с помощью хелперов типа [skip.in][skip-in] и тому подобных, то триггерится событие [TEST_PENDING](#test_pending).
+
+Далее воркеры получают от мастер-процесса информацию о конкретных тестах, которые они должны запустить. Так как тесты хранятся в файлах, то воркеры читают конкретно те файлы, в которых находятся требуемые тесты. И перед чтением каждого такого файла, в каждом воркере триггерится событие [BEFORE_FILE_READ](#before_file_read), а после прочтения — событие [AFTER_FILE_READ](#after_file_read).
+
+После того как соответствующие файлы с тестами будут прочитаны воркером, триггерится событие [AFTER_TESTS_READ](#after_tests_read).
+
+Перечисленные 3 события — [BEFORE_FILE_READ](#before_file_read), [AFTER_FILE_READ](#after_file_read) и [AFTER_TESTS_READ](#after_tests_read) будут триггериться в воркерах в процессе прогона тестов каждый раз как воркеры будут получать от мастер-процесса очередные тесты, которые нужно запустить. Кроме случаев, когда соответствующий файл с тестами уже был прочитан воркером ранее. Так как после первого чтения какого-либо файла, воркер сохраняет его в кэше, чтобы в следующий раз избежать повторного чтения файла с тестами.
+
+<Admonition type="info" title="Почему файл может запрашиваться несколько раз?">
+    Потому что один файл может содержать множество тестов. А запуск тестов идет по отдельным тестам,
+    а не по файлам. Поэтому в какой-то момент времени может прогоняться тест из файла, из которого
+    уже прогонялся другой тест. В таких случаях кэширование защищает от ненужных повторных чтений
+    одних и тех же файлов.
+</Admonition>
+
+Прежде чем тест будет запущен, триггерится событие [NEW_BROWSER](#new_browser). Однако это событие будет триггериться не для всех тестов, так как один и тот же браузер может использоваться много раз для запуска тестов (см. параметр [sessionsPerBrowser][browser-sessions-per-browser]). Также в случае падения теста с критической ошибкой происходит пересоздание браузера, чтобы не допустить падения других тестов в этом браузере из-за системного сбоя. В этом случае снова будет послано событие [NEW_BROWSER](#new_browser).
+
+#### Завершение тестов
+
+После того как тест завершается, может быть послано событие [SESSION_END](#session_end). Но это только в том случае, если суммарное количество тестов, которые были запущены в использованной сессии, превысило значение [testsPerSession][browser-tests-per-session].
+
+Далее всё будет зависеть от того, с каким результатом завершился прогон теста. Если тест прошел успешно, то testplane стриггерит событие [TEST_PASS](#test_pass). Если тест упал — [TEST_FAIL](#test_fail). Если тест упал, но его следует запустить повторно (см. настройки [retry][browsers-retry] и [shouldRetry][browsers-should-retry] в конфиге testplane), то вместо события [TEST_FAIL](#test_fail) будет отправлено событие [RETRY](#retry).
+
+Если тест не нужно запускать повторно, и результат — окончательный, то testplane триггерит события [TEST_END](#test_end) и [SUITE_END](#suite_end), если речь идет о завершении выполнения describe-блока.
+
+После того как все тесты будут выполнены, а сессии завершены, testplane триггерит события [END](#end) и [RUNNER_END](#runner_end).
+
+#### Обновление эталонных скриншотов
+
+Во время запуска тестов может произойти обновление эталонных скриншотов. Это может произойти по следующим причинам:
+
+-   разработчик запустил testplane в специальном GUI-режиме и дал команду «принять скриншоты»;
+-   разработчик указал опцию `--update-ref` при запуске testplane;
+-   у тестов не было эталонных скриншотов.
+
+Во всех этих случаях триггерится событие [UPDATE_REFERENCE](#update_reference).
+
+#### Ошибки и аварийное завершение работы
+
+Если во время прогона тестов, в [одном из перехватчиков событий](#events_interception) произойдет критическая ошибка, то testplane стриггерит для этого теста событие [ERROR](#error). При этом остальные тесты будут выполняться в штатном порядке.
+
+Если во время прогона тестов, testplane получит сигнал [SIGTERM][sigterm] (например, в результате нажатия клавиш `Ctrl + C`), то testplane стриггерит событие [EXIT](#exit) и досрочно прервет выполнение тестов.
+
+### Про перехват событий {#events_interception}
+
+Testplane позволяет разработчику перехватывать ряд событий и изменять их на другие, игнорировать или задерживать их обработку.
+
+События, которые могут быть перехвачены, снабжены в описании тегом _can be intercepted_. Всего таких событий 7:
+
+-   [SUITE_BEGIN](#suite_begin)
+-   [SUITE_END](#suite_end)
+-   [TEST_BEGIN](#test_begin)
+-   [TEST_END](#test_end)
+-   [TEST_PASS](#test_pass)
+-   [TEST_FAIL](#test_fail)
+-   [RETRY](#retry)
+
+#### Меняем одно событие на другое
+
+Например, код ниже показывает, как можно перехватывать событие [TEST_FAIL](#test_fail) и изменять его на событие [TEST_PENDING](#test_pending) — то есть автоматически отключать падающие тесты, не давая им уронить общий прогон тестов:
+
+```javascript
+module.exports = testplane => {
+    testplane.intercept(testplane.events.TEST_FAIL, ({ event, data }) => {
+        const test = Object.create(data);
+        test.pending = true;
+        test.skipReason = "intercepted failure";
+
+        return { event: testplane.events.TEST_PENDING, data: test };
+    });
+
+    testplane.on(testplane.events.TEST_FAIL, test => {
+        // этот обработчик никогда не будет вызван
+    });
+
+    testplane.on(testplane.evenst.TEST_PENDING, test => {
+        // этот обработчик будет всегда вызываться вместо обработчика для TEST_FAIL
+    });
+};
+```
+
+#### Оставляем событие as is {#events_interception_leaving_event_as_is}
+
+Если по какой-либо причине перехваченное событие нужно оставить _как есть_, то его обработчик должен вернуть точно такой же объект или любое _falsey_ значение: _undefined, null_ или _false._
+
+```javascript
+module.exports = testplane => {
+    testplane.intercept(testplane.events.TEST_FAIL, ({ event, data }) => {
+        return { event, data };
+        // или return;
+        // или return null;
+        // или return false;
+    });
+
+    testplane.on(testplane.events.TEST_FAIL, test => {
+        // этот обработчик будет вызван как обычно,
+        // потому что перехват события TEST_FAIL никак не меняет его
+    });
+};
+```
+
+#### Игнорируем событие {#events_interception_ignoring_event}
+
+Чтобы проигнорировать какое-либо событие и не дать ему распространяться дальше, нужно вернуть из обработчика (в котором перехватывается событие) пустой объект:
+
+```javascript
+module.exports = testplane => {
+    testplane.intercept(testplane.events.TEST_FAIL, ({ event, data }) => {
+        return {};
+    });
+
+    testplane.on(testplane.events.TEST_FAIL, test => {
+        // этот обработчик никогда не будет вызван
+    });
+};
+```
+
+#### Задерживаем обработку события {#events_interception_delaying_events}
+
+Приведенный выше подход с игнорированием события можно использовать для задержки появления тех или иных событий, например:
+
+```javascript
+module.exports = testplane => {
+    const intercepted = [];
+
+    testplane.intercept(testplane.events.TEST_FAIL, ({ event, data }) => {
+        // собираем все события TEST_FAIL
+        intercepted.push({ event, data });
+        // и не даем им распространяться дальше
+        return {};
+    });
+
+    testplane.on(testplane.events.END, () => {
+        // после окончания прогона тестов, триггерим все накопленные события TEST_FAIL
+        intercepted.forEach(({ event, data }) => testplane.emit(event, data));
+    });
+};
+```
+
+### Передача информации между обработчиками событий {#events_handlers_info_interchange}
+
+События, которые триггерятся в мастер-процессе и в воркерах testplane не могут обмениваться информацией через глобальные переменные.
+
+Например, такой подход работать не будет:
+
+```javascript
+module.exports = testplane => {
+    let flag = false;
+
+    testplane.on(testplane.events.RUNNER_START, () => {
+        flag = true;
+    });
+
+    testplane.on(testplane.events.NEW_BROWSER, () => {
+        // будет выведено значение false, потому что событие NEW_BROWSER
+        // триггерится в воркере testplane, а RUNNER_START – в мастер-процессе
+        console.info(flag);
+    });
+
+    testplane.on(testplane.events.RUNNER_END, () => {
+        // будет выведено значение true
+        console.info(flag);
+    });
+};
+```
+
+Но можно решить проблему следующим образом:
+
+```javascript
+module.exports = (testplane, opts) => {
+    testplane.on(testplane.events.RUNNER_START, () => {
+        opts.flag = true;
+    });
+
+    testplane.on(testplane.events.NEW_BROWSER, () => {
+        // будет выведено значение true, потому что свойства в конфиге,
+        // которые имеют примитивный тип (а переменная "opts" является частью конфига),
+        // автоматически передаются в воркеры во время события RUNNER_START
+        console.info(opts.flag);
+    });
+};
+```
+
+Или следующим образом: смотрите [пример](#new_worker_process_usage) из описания события [NEW_WORKER_PROCESS](#new_worker_process).
+
+### Параллельное выполнение кода плагина {#plugin_code_parallel_execution}
+
+У раннера тестов есть метод `registerWorkers`, который регистрирует код плагина для параллельного выполнения в воркерах testplane. Метод принимает следующие параметры:
+
+<table>
+<thead>
+<tr><td>**Параметр**</td><td>**Тип**</td><td>**Описание**</td></tr>
+</thead>
+<tbody>
+<tr><td>workerFilepath</td><td>String</td><td>Абсолютный путь к воркеру.</td></tr>
+<tr><td>exportedMethods</td><td>String[]</td><td>Список экспортируемых методов.</td></tr>
+
+</tbody>
+</table>
+
+При этом возвращает объект, который содержит асинхронные функции с именами из экспортированных методов.
+
+Файл с путем `workerFilepath` должен экспортировать объект, который содержит асинхронные функции с именами из `exportedMethods`.
+
+#### Пример параллельного выполнения кода плагина {#plugin_code_parallel_execution_example}
+
+**Код плагина: plugin.js**
+
+```javascript
+let workers;
+
+module.exports = testplane => {
+    testplane.on(testplane.events.RUNNER_START, async runner => {
+        const workerFilepath = require.resolve("./worker");
+        const exportedMethods = ["foo"];
+
+        workers = runner.registerWorkers(workerFilepath, exportedMethods);
+
+        // выводит FOO_RUNNER_START
+        console.info(await workers.foo("RUNNER_START"));
+    });
+
+    testplane.on(testplane.events.RUNNER_END, async () => {
+        // выводит FOO_RUNNER_END
+        console.info(await workers.foo("RUNNER_END"));
+    });
+};
+```
+
+**Код воркера: worker.js**
+
+```javascript
+module.exports = {
+    foo: async function (event) {
+        return "FOO_" + event;
+    },
+};
+```
+
+## CLI {#cli}
+
+**sync | master**
+
+Событие `CLI` триггерится сразу при запуске, до того, как testplane распарсит [CLI][cli-wiki]. Обработчик события выполняется синхронно. С помощью него можно добавить новые команды или расширить справку testplane.
+
+### Подписка на событие {#cli_subscription}
+
+```javascript
+testplane.on(testplane.events.CLI, cli => {
+    console.info("Выполняется обработка события CLI...");
+
+    cli.option(
+        "--some-option <some-value>",
+        "the full description of the option",
+        // см. подробнее в https://github.com/tj/commander.js#options
+    );
+});
+```
+
+#### Параметры обработчика {#cli_cb_params}
+
+В обработчик события передается объект типа [Commander][commander].
+
+### Пример использования {#cli_usage}
+
+Рассмотрим в качестве примера [реализацию][testplane-test-repeater-index] плагина [testplane-test-repeater][testplane-test-repeater].
+
+Используя событие [CLI](#cli), плагин добавляет к testplane новую опцию `--repeat`. С помощью неё можно указать, сколько раз нужно прогнать тесты, независимо от результата каждого прогона.
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+const parseConfig = require('./config');
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled <tr><td>testplane.isWorker()) {
+        // или плагин отключен, или мы находимся в контексте воркера – уходим
+        return;
+    }
+
+    testplane.on(testplane.events.CLI, (cli) => {
+        // добавляем опцию --repeat
+        cli.option(
+            '--repeat <number>',
+            'how many times tests should be repeated regardless of the result',
+            (value) => parseNonNegativeInteger(value, 'repeat')
+        );
+    });
+
+    // ...
+};
+```
+
+</details>
+
+## INIT {#init}
+
+**async | master**
+
+Событие `INIT` триггерится перед тем, как будут выполнены задачи [run][run] или [readTests][read-tests]. Обработчик события может быть асинхронным: в таком случае задачи начнут выполняться только после того, как будет разрезолвлен _Promise_, возвращаемый обработчиком события. Событие триггерится только один раз, независимо от того, сколько раз будут выполнены задачи.
+
+### Подписка на событие {#init_subscription}
+
+```javascript
+testplane.on(testplane.events.INIT, async () => {
+    console.info("Выполняется обработка события INIT...");
+});
+```
+
+#### Параметры обработчика {#init_cb_params}
+
+В обработчик события никакие данные не передаются.
+
+### Пример использования {#init_usage}
+
+В обработчике события [INIT](#init) можно организовать, например, запуск dev-сервера для вашего проекта.
+
+<Admonition type="info" title="Что такое dev-сервер?">
+    Dev-сервер — это [express][express]-like приложение, которое позволяет разрабатывать фронтенд
+    проекта.
+</Admonition>
+
+Ниже приведена самая короткая реализация. Более подробный пример можно посмотреть в разделе «[Автоматический запуск dev-сервера](#usage_starting_dev_server)».
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+const http = require('http');
+const parseConfig = require('./config');
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled</td></tr> testplane.isWorker()) {
+        // или плагин отключен, или мы находимся в контексте воркера – уходим
+        return;
+    }
+
+    // ...
+
+    testplane.on(testplane.events.INIT, () => {
+        // контент, который отдает dev-сервер
+        const content = '<h1>Hello, World!</h1>';
+
+        // создаем сервер и начинаем слушать порт 3000
+        http
+            .createServer((req, res) => res.end(content))
+            .listen(3000);
+
+        // по адресу http://localhost:3000/index.html будет отдаваться: <h1>Hello, World!</h1>
+    });
+};
+```
+
+</details>
+
+## BEFORE_FILE_READ {#before_file_read}
+
+**sync | master | worker**
+
+Событие `BEFORE_FILE_READ` триггерится перед тем, как будет прочитан файл с тестом, чтобы распарсить его. Обработчик события выполняется синхронно. Событие также доступно в воркерах testplane.
+
+### Подписка на событие {#before_file_read_subscription}
+
+```javascript
+testplane.on(testplane.events.BEFORE_FILE_READ, ({ file, testplane, testParser }) => {
+    testParser.setController("<some-command-name>", {
+        "<some-helper>": function (matcher) {
+            // ...
+        },
+    });
+});
+```
+
+#### Параметры обработчика {#before_file_read_cb_params}
+
+В обработчик события передается объект следующего формата:
+
+```javascript
+{
+    file, // String: путь к файлу с тестом
+        testplane, // Object: то же, что и global.testplane
+        testParser; // Object: типа TestParserAPI
+}
+```
+
+#### testParser: TestParserAPI {#test_parser}
+
+Объект `testParser` типа `TestParserAPI` передается в обработчик события `BEFORE_FILE_READ`. С помощью него можно управлять процессом парсинга файлов с тестами. Объект поддерживает метод `setController`, с помощью которого можно создать свои хелперы для тестов.
+
+**setController(name, methods)**
+
+Метод добавляет контроллер к глобальному объекту `testplane`, доступному внутри тестов.
+
+-   `name` — имя хелпера (или иначе — контроллера);
+-   `methods` — объект-словарь, ключи которого задают названия методов соответствующих хелперов, а значения ключей определяют их реализацию. Каждый метод будет вызван на соответствующем тесте или наборе тестов _(suite)_.
+
+<Admonition type="info">
+    Контроллер будет удален, как только закончится парсинг текущего файла.
+</Admonition>
+
+### Пример использования {#before_file_read_usage}
+
+Создадим в качестве примера специальный хелпер `testplane.logger.log()`, с помощью которого мы сможем логировать информацию о парсинге интересующего нас теста.
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть пример использования
+
+</summary>
+
+**Код плагина**
+
+```javascript
+testplane.on(testplane.events.BEFORE_FILE_READ, ({ file, testParser }) => {
+    testParser.setController("logger", {
+        log: function (prefix) {
+            console.log(
+                `${prefix}: только что распарсил ${this.fullTitle()} из файла ${file} для браузера ${this.browserId}`,
+            );
+        },
+    });
+});
+```
+
+**Код теста**
+
+```javascript
+describe("foo", () => {
+    testplane.logger.log("some-prefix");
+    it("bar", function () {
+        // ...
+    });
+});
+```
+
+</details>
+
+Ещё один пример использования события [BEFORE_FILE_READ](#before_file_read) можно посмотреть в разделе «[Запуск тестов с хелперами](#usage_running_tests_with_helpers)».
+
+## AFTER_FILE_READ {#after_file_read}
+
+**sync | master | worker**
+
+Событие `AFTER_FILE_READ` триггерится после того, как будет прочтен файл с тестом. Обработчик события выполняется синхронно. Событие также доступно в воркерах testplane.
+
+### Подписка на событие {#after_file_read_subscription}
+
+```javascript
+testplane.on(testplane.events.AFTER_FILE_READ, ({ file, testplane }) => {
+    console.info("Выполняется обработка события AFTER_FILE_READ...");
+});
+```
+
+#### Параметры обработчика {#after_file_read_cb_params}
+
+В обработчик события передается объект следующего формата:
+
+```javascript
+{
+    file, // String: путь к файлу с тестом
+        testplane; // Object: то же, что и global.testplane
+}
+```
+
+## AFTER_TESTS_READ {#after_tests_read}
+
+**sync | master | worker**
+
+Событие `AFTER_TESTS_READ` триггерится после того, как будут вызваны методы [readTests][read-tests] или [run][run] объекта типа [TestCollection][test-collection]. Обработчик события выполняется синхронно. Событие также доступно в воркерах testplane.
+
+Подписавшись на это событие, вы можете выполнить в обработчике те или иные манипуляции над коллекцией тестов до того, как они будут запущены. Например, вы можете исключить какие-либо тесты из запусков.
+
+### Подписка на событие {#after_tests_read_subscription}
+
+```javascript
+testplane.on(testplane.events.AFTER_TESTS_READ, testCollection => {
+    console.info("Выполняется обработка события AFTER_TESTS_READ...");
+});
+```
+
+#### Параметры обработчика {#after_tests_read_cb_params}
+
+В обработчик события передается объект `testCollection` типа [TestCollection][test-collection].
+
+### Пример использования {#after_tests_read_usage}
+
+Рассмотрим [реализацию][testplane-global-hook-index] плагина [testplane-global-hook][testplane-global-hook], с помощью которого можно вынести действия, повторяющиеся перед запуском и завершением каждого теста, в отдельные _beforeEach_- и _afterEach_-обработчики.
+
+Используя событие [AFTER_TESTS_READ](#after_tests_read), плагин добавляет к каждому корневому _suite_ обработчики _beforeEach_ и _afterEach_-хуков. Последние задаются пользователем в конфиге плагина [testplane-global-hook][testplane-global-hook].
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+const parseConfig = require("./config");
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    // ...
+
+    const { beforeEach, afterEach } = pluginConfig;
+
+    testplane.on(testplane.events.AFTER_TESTS_READ, testCollection => {
+        testCollection.eachRootSuite(root => {
+            beforeEach && root.beforeEach(beforeEach);
+            afterEach && root.afterEach(afterEach);
+        });
+    });
+};
+```
+
+</details>
+
+Ещё примеры использования события [AFTER_TESTS_READ](#after_tests_read) можно посмотреть в разделах «[Запуск тестов из заданного списка](#usage_running_filtered_tests)» и «[Запуск тестов с хелперами](#usage_running_tests_with_helpers)».
+
+## RUNNER_START {#runner_start}
+
+**async | master**
+
+Событие `RUNNER_START` триггерится после инициализации всех воркеров testplane и перед выполнением тестов. Обработчик события может быть асинхронным: в таком случае тесты начнут выполняться только после того, как будет разрезолвлен _Promise_, возвращаемый обработчиком события.
+
+### Подписка на событие {#runner_start_subscription}
+
+```javascript
+testplane.on(testplane.events.RUNNER_START, async runner => {
+    console.info("Выполняется обработка события RUNNER_START...");
+});
+```
+
+#### Параметры обработчика {#runner_start_cb_params}
+
+В обработчик события передается ссылка на инстанс раннера. Используя этот инстанс, можно триггерить различные события или подписаться на них.
+
+### Пример использования {#runner_start_usage}
+
+Предположим, мы хотим автоматически поднимать ssh-туннель при запуске тестов и перенаправлять все урлы в тестах в поднятый туннель. Для этого мы можем воспользоваться событиями [RUNNER_START](#runner_start) и [RUNNER_END](#runner_end), чтобы открывать туннель при запуске раннера и закрывать его после завершения работы раннера.
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+const parseConfig = require("./config");
+const Tunnel = require("./lib/tunnel");
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled) {
+        // плагин отключен – уходим
+        return;
+    }
+
+    // конфиг плагина задает параметры туннеля:
+    // host, ports, localport, retries, etc.
+    const tunnel = Tunnel.create(testplane.config, pluginConfig);
+
+    testplane.on(testplane.events.RUNNER_START, () => tunnel.open());
+    testplane.on(testplane.events.RUNNER_END, () => tunnel.close());
+};
+```
+
+</details>
+
+Похожую [реализацию][ssh-tunneler-index] можно посмотреть в плагине [ssh-tunneler][ssh-tunneler].
+
+## RUNNER_END {#runner_end}
+
+**async | master**
+
+Событие `RUNNER_END` триггерится после выполнения теста и перед тем, как будут завершены все воркеры. Обработчик события может быть асинхронным: в таком случае все воркеры будут завершены только после того, как будет разрезолвлен _Promise_, возвращаемый обработчиком события.
+
+### Подписка на событие {#runner_end_subscription}
+
+```javascript
+testplane.on(testplane.events.RUNNER_END, async result => {
+    console.info("Выполняется обработка события RUNNER_END...");
+});
+```
+
+#### Параметры обработчика {#runner_end_cb_params}
+
+В обработчик события передается объект со статистикой прогона тестов следующего вида:
+
+```javascript
+{
+    passed: 0,  // количество успешно выполненных тестов
+    failed: 0,  // количество упавших тестов
+    retries: 0, // количество ретраев (повторных запусков) тестов
+    skipped: 0, // количество отключенных (заскипанных) тестов
+    total: 0    // общее количество тестов
+};
+```
+
+### Пример использования {#runner_end_usage}
+
+Смотрите пример [выше](#runner_start_usage) про открытие и закрытие туннеля при запуске и остановке раннера.
+
+## NEW_WORKER_PROCESS {#new_worker_process}
+
+**sync | master**
+
+Событие `NEW_WORKER_PROCESS` триггерится после порождения нового подпроцесса (воркера) testplane. Обработчик события выполняется синхронно.
+
+### Подписка на событие {#new_worker_process_subscription}
+
+```javascript
+testplane.on(testplane.events.NEW_WORKER_PROCESS, workerProcess => {
+    console.info("Выполняется обработка события NEW_WORKER_PROCESS...");
+});
+```
+
+#### Параметры обработчика {#new_worker_process_cb_params}
+
+В обработчик события передается объект-обертка над порожденным подпроцессом, с одним единственным методом [send][process-send] для обмена сообщениями.
+
+### Пример использования {#new_worker_process_usage}
+
+В примере ниже показано, как можно использовать событие [NEW_WORKER_PROCESS](#new_worker_process), чтобы организовать взаимодействие мастер-процесса со всеми воркерами testplane. Например, для того, чтобы обновить значение какого-либо параметра во всех воркерах testplane из мастер-процесса перед началом прогона всех тестов.
+
+В примере также используется событие [BEGIN](#begin).
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+const masterPlugin = (testplane, opts) => {
+    const workers = [];
+
+    testplane.on(testplane.events.NEW_WORKER_PROCESS, (workerProcess) => {
+        // запоминаем ссылки на все созданные воркеры testplane
+        workers.push(workerProcess);
+    });
+
+    testplane.on(testplane.events.BEGIN, () => {
+        // посылаем значение параметра всем воркерам
+        workers.forEach((worker) => {
+            worker.send({
+                type: PARAM_VALUE_UPDATED_EVENT,
+                param: 'some-value'
+            });
+        });
+    });
+};
+
+const workerPlugin = (testplane) => {
+    process.on('message', ({ type, ...data }) => {
+        if (type === PARAM_VALUE_UPDATED_EVENT) {
+            const { param } = data;
+            console.info(`Получил значение "${param}" для "param" из мастер-процесса`);
+        }
+    });
+
+    ...
+};
+
+const plugin = (testplane, opts) => {
+    if (testplane.isWorker()) {
+        workerPlugin(testplane, opts);
+    } else {
+        masterPlugin(testplane, opts);
+    }
+};
+
+module.exports = plugin;
+```
+
+</details>
+
+## SESSION_START {#session_start}
+
+**async | master**
+
+Событие `SESSION_START` триггерится после инициализации сессии браузера. Обработчик события может быть асинхронным: в таком случае тесты начнут выполняться только после того, как будет разрезолвлен _Promise_, возвращаемый обработчиком события.
+
+### Подписка на событие {#session_start_subscription}
+
+```javascript
+testplane.on(testplane.events.SESSION_START, async (browser, { browserId, sessionId }) => {
+    console.info("Выполняется обработка события SESSION_START...");
+});
+```
+
+#### Параметры обработчика {#session_start_cb_params}
+
+В обработчик события передаются 2 аргумента:
+
+-   первый аргумент — инстанс `WebdriverIO`;
+-   второй аргумент — объект вида `{ browserId, sessionId }`, где _browserId_ — это имя браузера, а _sessionId_ — идентификатор сессии браузера.
+
+### Пример использования {#session_start_usage}
+
+Рассмотрим пример, в котором плагин подписывается на событие [SESSION_START](#session_start), чтобы отключить скролл-бары в браузерах с помощью Chrome DevTools Protocol'а.
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+const parseConfig = require("./config");
+const DevTools = require("./dev-tools");
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled) {
+        // плагин отключен – уходим
+        return;
+    }
+
+    testplane.on(testplane.events.SESSION_START, async (browser, { browserId, sessionId }) => {
+        if (!pluginConfig.browsers.includes(browserId)) {
+            // браузера нет в списке браузеров, для которых возможно отключить скроллбары
+            // посредством Chrome DevTools Protocol'а (CDP) – уходим
+            return;
+        }
+
+        const gridUrl = testplane.config.forBrowser(browserId).gridUrl;
+
+        // pluginConfig.browserWSEndpoint задает функцию, которая должна вернуть URL
+        // для работы с браузером через CDP. Чтобы функция могла вычислить URL,
+        // в функцию передаются идентификатор сессии и ссылка на грид
+        const browserWSEndpoint = pluginConfig.browserWSEndpoint({ sessionId, gridUrl });
+
+        const devtools = await DevTools.create({ browserWSEndpoint });
+
+        devtools.setScrollbarsHiddenOnNewPage();
+
+        await devtools.hideScrollbarsOnActivePages();
+    });
+};
+```
+
+</details>
+
+Более подробную [реализацию][hermione-hide-scrollbars-index] можно посмотреть в плагине [hermione-hide-scrollbars][hermione-hide-scrollbars].
+
+## SESSION_END {#session_end}
+
+**async | master**
+
+Событие `SESSION_END` триггерится после того, как завершается сессия браузера. Обработчик события может быть асинхронным: в таком случае тесты продолжат выполняться только после того, как будет разрезолвлен _Promise_, возвращаемый обработчиком события.
+
+### Подписка на событие {#session_end_subscription}
+
+```javascript
+testplane.on(testplane.events.SESSION_END, async (browser, { browserId, sessionId }) => {
+    console.info("Выполняется обработка события SESSION_END...");
+});
+```
+
+#### Параметры обработчика {#session_end_cb_params}
+
+В обработчик события передаются 2 аргумента:
+
+-   первый аргумент — инстанс `WebdriverIO`;
+-   второй аргумент — объект вида `{ browserId, sessionId }`, где _browserId_ — это имя браузера, а _sessionId_ — идентификатор сессии браузера.
+
+## BEGIN {#begin}
+
+**sync | master**
+
+Событие `BEGIN` триггерится перед выполнением теста, но после того как все раннеры будут инициализированы. Обработчик события выполняется синхронно.
+
+### Подписка на событие {#begin_subscription}
+
+```javascript
+testplane.on(testplane.events.BEGIN, () => {
+    console.info("Выполняется обработка события BEGIN...");
+});
+```
+
+#### Параметры обработчика {#begin_cb_params}
+
+В обработчик события никакие данные не передаются.
+
+### Пример использования {#begin_usage}
+
+Смотрите пример [выше](#new_worker_process_usage) про организацию взаимодействия мастер-процесса testplane со всеми воркерами.
+
+## END {#end}
+
+**sync | master**
+
+Событие `END` триггерится прямо перед событием `RUNNER_END`. Обработчик события выполняется синхронно.
+
+### Подписка на событие {#end_subscription}
+
+```javascript
+testplane.on(testplane.events.END, () => {
+    console.info("Выполняется обработка события END...");
+});
+```
+
+#### Параметры обработчика {#end_cb_params}
+
+В обработчик события никакие данные не передаются.
+
+### Пример использования {#end_usage}
+
+В качестве примера использования события [END](#end) смотрите раздел «[Задерживаем обработку события](#events_interception_delaying_events)».
+
+## SUITE_BEGIN {#suite_begin}
+
+**sync | master | can be intercepted**
+
+Событие `SUITE_BEGIN` триггерится перед выполнением набора тестов _(suite)_. Обработчик события выполняется синхронно.
+
+### Подписка на событие {#suite_begin_subscription}
+
+```javascript
+testplane.on(testplane.events.SUITE_BEGIN, suite => {
+    console.info(`Выполняется обработка события SUITE_BEGIN для "${suite.fullTitle()}"...`);
+});
+```
+
+#### Параметры обработчика {#suite_begin_cb_params}
+
+В обработчик события передается инстанс _suite_.
+
+### Перехват события {#suite_begin_interception}
+
+```javascript
+testplane.intercept(testplane.events.SUITE_BEGIN, ({ event, data: suite }) => {
+    console.info(`Выполняется перехват события SUITE_BEGIN для "${suite.fullTitle()}"...`);
+});
+```
+
+## SUITE_END {#suite_end}
+
+**sync | master | can be intercepted**
+
+Событие `SUITE_END` триггерится после окончания выполнения набора тестов _(suite)_. Обработчик события выполняется синхронно.
+
+### Подписка на событие {#suite_end_subscription}
+
+```javascript
+testplane.on(testplane.events.SUITE_END, suite => {
+    console.info(`Выполняется обработка события SUITE_END для "${suite.fullTitle()}"...`);
+});
+```
+
+#### Параметры обработчика {#suite_end_cb_params}
+
+В обработчик события передается инстанс _suite_.
+
+### Перехват события {#suite_end_interception}
+
+```javascript
+testplane.intercept(testplane.events.SUITE_END, ({ event, data: suite }) => {
+    console.info(`Выполняется перехват события SUITE_END для "${suite.fullTitle()}"...`);
+});
+```
+
+## TEST_BEGIN {#test_begin}
+
+**sync | master | can be intercepted**
+
+Событие `TEST_BEGIN` триггерится перед выполнением теста. Обработчик события выполняется синхронно.
+
+### Подписка на событие {#test_begin_subscription}
+
+```javascript
+testplane.on(testplane.events.TEST_BEGIN, test => {
+    if (test.pending) {
+        // тест отключен, ничего делать не нужно
+        return;
+    }
+
+    console.info(
+        `Выполняется обработка события TEST_BEGIN ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+#### Параметры обработчика {#test_begin_cb_params}
+
+В обработчик события передается инстанс теста.
+
+### Перехват события {#test_begin_interception}
+
+```javascript
+testplane.intercept(testplane.events.TEST_BEGIN, ({ event, data: test }) => {
+    console.info(
+        `Выполняется перехват события TEST_BEGIN ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+### Пример использования {#test_begin_usage}
+
+Смотрите в качестве примера «[Профилирование прогона тестов](#usage_profiling_tests_runs)».
+
+## TEST_END {#test_end}
+
+**sync | master | can be intercepted**
+
+Событие `TEST_END` триггерится после окончания выполнения теста. Обработчик события выполняется синхронно. Также событие можно перехватить и изменить в специальном обработчике.
+
+### Подписка на событие {#test_end_subscription}
+
+```javascript
+testplane.on(testplane.events.TEST_END, test => {
+    if (test.pending) {
+        // тест отключен, ничего делать не нужно
+        return;
+    }
+
+    console.info(
+        `Выполняется обработка события TEST_END ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+#### Параметры обработчика {#test_end_cb_params}
+
+В обработчик события передается инстанс теста.
+
+### Перехват события {#test_end_interception}
+
+```javascript
+testplane.intercept(testplane.events.TEST_END, ({ event, data: test }) => {
+    console.info(
+        `Выполняется перехват события TEST_END ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+### Пример использования {#test_end_usage}
+
+Смотрите в качестве примера «[Профилирование прогона тестов](#usage_profiling_tests_runs)».
+
+## TEST_PASS {#test_pass}
+
+**sync | master | can be intercepted**
+
+Событие `TEST_PASS` триггерится, если тест успешно прошел. Обработчик события выполняется синхронно. Также событие можно перехватить и изменить в специальном обработчике.
+
+### Подписка на событие {#test_pass_subscription}
+
+```javascript
+testplane.on(testplane.events.TEST_PASS, test => {
+    console.info(
+        `Выполняется обработка события TEST_PASS ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+#### Параметры обработчика {#test_pass_cb_params}
+
+В обработчик события передается инстанс теста.
+
+### Перехват события {#test_pass_interception}
+
+```javascript
+testplane.intercept(testplane.events.TEST_PASS, ({ event, data: test }) => {
+    console.info(
+        `Выполняется перехват события TEST_PASS ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+### Пример использования {#test_pass_usage}
+
+Смотрите в качестве примера «[Сбор статистики о прогоне тестов](#usage_collecting_stats)».
+
+## TEST_FAIL {#test_fail}
+
+**sync | master | can be intercepted**
+
+Событие `TEST_FAIL` триггерится, если тест упал. Обработчик события выполняется синхронно. Также событие можно перехватить и изменить в специальном обработчике.
+
+### Подписка на событие {#test_fail_subscription}
+
+```javascript
+testplane.on(testplane.events.TEST_FAIL, test => {
+    console.info(
+        `Выполняется обработка события TEST_FAIL ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+#### Параметры обработчика {#test_fail_cb_params}
+
+В обработчик события передается инстанс теста.
+
+### Перехват события {#test_fail_interception}
+
+```javascript
+testplane.intercept(testplane.events.TEST_FAIL, ({ event, data }) => {
+    console.info(
+        `Выполняется перехват события TEST_PASS ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+### Пример использования {#test_fail_usage}
+
+Смотрите в качестве примера «[Сбор статистики о прогоне тестов](#usage_collecting_stats)».
+
+## TEST_PENDING {#test_pending}
+
+**sync | master**
+
+Событие `TEST_PENDING` триггерится, если тест отключен. Обработчик события выполняется синхронно.
+
+### Подписка на событие {#test_pending_subscription}
+
+```javascript
+testplane.on(testplane.events.TEST_PENDING, test => {
+    console.info(
+        `Выполняется обработка события TEST_PENDING ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+#### Параметры обработчика {#test_pending_cb_params}
+
+В обработчик события передается инстанс теста.
+
+### Пример использования {#test_pending_usage}
+
+Смотрите в качестве примера «[Сбор статистики о прогоне тестов](#usage_collecting_stats)».
+
+## RETRY {#retry}
+
+**sync | master | can be intercepted**
+
+Событие `RETRY` триггерится, если тест упал, но ушел на повторный прогон, так называемый «ретрай». Возможности повторного прогона теста определяются настройками [retry][browsers-retry] и [shouldRetry][browsers-should-retry] в конфиге testplane. Также на это могут влиять плагины testplane, если они модифицируют «на лету» указанные выше настройки. Смотрите для примера плагины [retry-limiter][retry-limiter] и [testplane-retry-progressive][testplane-retry-progressive].
+
+Обработчик события выполняется синхронно. Также событие можно перехватить и изменить в специальном обработчике.
+
+### Подписка на событие {#retry_subscription}
+
+```javascript
+testplane.on(testplane.events.RETRY, test => {
+    console.info(
+        `Выполняется обработка события RETRY ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+#### Параметры обработчика {#retry_cb_params}
+
+В обработчик события передается инстанс теста.
+
+### Перехват события {#retry_interception}
+
+```javascript
+testplane.intercept(testplane.events.RETRY, ({ event, data: test }) => {
+    console.info(
+        `Выполняется перехват события RETRY ` +
+            `для теста "${test.fullTitle()}" в браузере "${test.browserId}"...`,
+    );
+});
+```
+
+### Пример использования {#test_retry_usage}
+
+Смотрите в качестве примера «[Сбор статистики о прогоне тестов](#usage_collecting_stats)».
+
+## ERROR {#error}
+
+**sync | master**
+
+Событие `ERROR` триггерится только из [перехватчиков событий](#events_interception) в случае критической ошибки. Обработчик события выполняется синхронно.
+
+### Подписка на событие {#error_subscription}
+
+```javascript
+testplane.on(testplane.events.ERROR, error => {
+    console.info("Выполняется обработка события ERROR...");
+});
+```
+
+#### Параметры обработчика {#error_cb_params}
+
+В обработчик события передается [объект с ошибкой][error-object].
+
+### Пример использования {#error_usage}
+
+Смотрите в качестве примера «[Профилирование прогона тестов](#usage_profiling_tests_runs)».
+
+## INFO {#info}
+
+**reserved**
+
+Зарезервировано.
+
+## WARNING {#warning}
+
+**reserved**
+
+Зарезервировано.
+
+## EXIT {#exit}
+
+**async | master**
+
+Событие `EXIT` триггерится при получении сигнала [SIGTERM][sigterm] (например, после нажатия `Ctrl + C`). Обработчик события может быть асинхронным.
+
+### Подписка на событие {#exit_subscription}
+
+```javascript
+testplane.on(testplane.events.EXIT, async () => {
+    console.info("Выполняется обработка события EXIT...");
+});
+```
+
+#### Параметры обработчика {#exit_cb_params}
+
+В обработчик события никакие данные не передаются.
+
+## NEW_BROWSER {#new_browser}
+
+**sync | worker**
+
+Событие `NEW_BROWSER` триггерится после того, как создан новый инстанс браузера. Обработчик события выполняется синхронно. Событие доступно только в воркерах testplane.
+
+### Подписка на событие {#new_browser_subscription}
+
+```javascript
+testplane.on(testplane.events.NEW_BROWSER, (browser, { browserId, browserVersion }) => {
+    console.info("Выполняется обработка события NEW_BROWSER...");
+});
+```
+
+#### Параметры обработчика {#new_browser_cb_params}
+
+В обработчик события передаются 2 аргумента:
+
+-   первый аргумент — инстанс `WebdriverIO`;
+-   второй аргумент — объект вида `{ browserId, versionId }`, где _browserId_ — это имя браузера, а _browserVersion_ — версия браузера.
+
+### Пример реализации {#new_browser_usage}
+
+Событие [NEW_BROWSER](#new_browser) часто используют для того, чтобы добавить новые команды к браузеру, или как-то дополнить уже существующие команды. Например, некоторые плагины добавляют кастомные команды к браузеру в обработчике события [NEW_BROWSER](#new_browser).
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+module.exports = (testplane, opts) => {
+    // ...
+
+    if (testplane.isWorker()) {
+        testplane.on(testplane.events.NEW_BROWSER, (browser, { browserId }) => {
+            // ...
+
+            browser.addCommand("vncUrl", vncUrlHandler);
+            browser.addCommand("openVnc", createOpenVnc(browser, ipcOptions));
+            browser.addCommand("waitForEnter", waitForEnter);
+        });
+    }
+};
+```
+
+</details>
+
+## UPDATE_REFERENCE {#update_reference}
+
+**sync | worker**
+
+Событие `UPDATE_REFERENCE` триггерится после обновления эталонных скриншотов. Обработчик события выполняется синхронно. Событие доступно только в воркерах testplane.
+
+### Подписка на событие {#update_reference_subscription}
+
+```javascript
+testplane.on(testplane.events.UPDATE_REFERENCE, ({ state, refImg }) => {
+    console.info("Выполняется обработка события UPDATE_REFERENCE...");
+});
+```
+
+#### Параметры обработчика {#update_reference_cb_params}
+
+В обработчик события передается объект следующего формата:
+
+```javascript
+{
+    state, // String: состояние, которое отражает данный скриншот, например: plain, map-view, scroll-left и т. д.
+        refImg; // Object: типа { path, size: { width, height } }, описывающий эталонный скриншот
+}
+```
+
+Параметр _refImg.path_ хранит путь к эталонному скриншоту на файловой системе, а _refImg.size.width_ и _refImg.size.height_ хранят, соответственно, ширину и высоту эталонного скриншота.
+
+### Пример использования {#update_reference_usage}
+
+Рассмотрим в качестве примера [реализацию][testplane-image-minifier-index] плагина [testplane-image-minifier][testplane-image-minifier], в котором при сохранении эталонных скриншотов происходит их автоматическое сжатие с заданным уровнем компрессии.
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+const parseConfig = require("./config");
+const Minifier = require("./minifier");
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled) {
+        // плагин отключен – уходим
+        return;
+    }
+
+    const minifier = Minifier.create(pluginConfig);
+
+    testplane.on(testplane.events.UPDATE_REFERENCE, ({ refImg }) => {
+        minifier.minify(refImg.path);
+    });
+};
+```
+
+</details>
+
+## Примеры использования событий
+
+### Запуск тестов из заданного списка {#usage_running_filtered_tests}
+
+Рассмотрим в качестве примера [реализацию][testplane-test-filter-index] плагина [testplane-test-filter][testplane-test-filter], с помощью которого можно запускать только заданные в json-файле тесты.
+
+В этом примере используются следующие события и методы API testplane:
+
+-   [INIT](#init)
+-   [AFTER_TESTS_READ](#after_tests_read)
+-   [TestCollection.disableAll][disable-all]
+-   [TestCollection.enableTest][enable-test]
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+const _ = require("lodash");
+const parseConfig = require("./config");
+const utils = require("./utils");
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled) {
+        // плагин отключен – уходим
+        return;
+    }
+
+    if (testplane.isWorker()) {
+        // в воркерах testplane нам нечего делать – уходим
+        return;
+    }
+
+    let input;
+
+    testplane.on(testplane.events.INIT, async () => {
+        // читаем файл со списком тестов, которые надо прогнать;
+        // readFile возвращает json, который содержит массив вида:
+        // [
+        //     { "fullTitle": "test-1", "browserId": "bro-1" },
+        //     { "fullTitle": "test-2", "browserId": "bro-2" }
+        // ]
+        input = await utils.readFile(pluginConfig.inputFile);
+    });
+
+    testplane.on(testplane.events.AFTER_TESTS_READ, testCollection => {
+        if (_.isEmpty(input)) {
+            // список тестов – пустой – будем запускать все тесты,
+            // то есть не трогаем исходную коллекцию (testCollection) тестов
+            return;
+        }
+
+        // отключаем все тесты
+        testCollection.disableAll();
+
+        // а теперь включаем только те, которые были переданы в json-файле
+        input.forEach(({ fullTitle, browserId }) => {
+            testCollection.enableTest(fullTitle, browserId);
+        });
+    });
+};
+```
+
+</details>
+
+### Сбор статистики о прогоне тестов {#usage_collecting_stats}
+
+Рассмотрим в качестве примера [реализацию][json-reporter-index] плагина [json-reporter][json-reporter].
+
+В этом примере используются следующие события testplane:
+
+-   [TEST_PASS](#test_pass)
+-   [TEST_FAIL](#test_fail)
+-   [TEST_PENDING](#test_pending)
+-   [RETRY](#retry)
+-   [RUNNER_END](#runner_end)
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+const Collector = require("./lib/collector");
+const testplaneToolCollector = require("./lib/collector/tool/testplane");
+const parseConfig = require("./lib/config");
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled) {
+        // плагин отключен – уходим
+        return;
+    }
+
+    // collector будет аккумулировать статистику
+    const collector = Collector.create(testplaneToolCollector, pluginConfig);
+
+    // подписываемся на соответствующие события,
+    // чтобы в итоге получить необходимую статистику:
+
+    // - сколько тестов выполнилось успешно
+    testplane.on(testplane.events.TEST_PASS, data => collector.addSuccess(data));
+
+    // - сколько тестов упало
+    testplane.on(testplane.events.TEST_FAIL, data => collector.addFail(data));
+
+    // - сколько было отключено (заскипано)
+    testplane.on(testplane.events.TEST_PENDING, data => collector.addSkipped(data));
+
+    // - количество ретраев
+    testplane.on(testplane.events.RETRY, data => collector.addRetry(data));
+
+    // после того, как прогон тестов завершен, сохраняем статистику в json-файл
+    testplane.on(testplane.events.RUNNER_END, () => collector.saveFile());
+};
+```
+
+</details>
+
+### Автоматический запуск dev-севера {#usage_starting_dev_server}
+
+Реализуем схематично плагин `testplane-dev-server` для testplane, чтобы при каждом запуске testplane автоматически поднимать dev-сервер.
+
+Запуск dev-сервера — опционален: для этого плагин добавляет специальную опцию `--dev-server` к testplane, позволяя разработчику указывать при запуске testplane, нужно ли поднимать dev-сервер.
+
+Помимо этого, плагин позволяет задать параметр `devServer` в своем конфиге.
+
+В этом примере используются следующие события testplane:
+
+-   [CLI](#cli)
+-   [INIT](#init)
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+**Код плагина**
+
+```javascript
+const http = require('http');
+const parseConfig = require('./config');
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled <tr><td>testplane.isWorker()) {
+        // или плагин отключен, или мы находимся в контексте воркера – уходим
+        return;
+    }
+
+    let program;
+
+    testplane.on(testplane.events.CLI, (cli) => {
+        // нужно сохранить ссылку на инстанс commander'а (https://github.com/tj/commander.js),
+        // чтобы потом проверить наличие опции
+        program = cli;
+        // добавляем к testplane опцию --dev-server,
+        // чтобы пользователь мог явно указывать, когда надо запустить dev-сервер
+        cli.option('--dev-server', 'run dev-server');
+    });
+
+    testplane.on(testplane.events.INIT, () => {
+        // dev-сервер может быть запущен как через указание опции --dev-server
+        // при запуске testplane, так и в настройках плагина
+        const devServer = program && program.devServer</td></tr> pluginConfig.devServer;
+
+        if (!devServer) {
+            // если dev-сервер запускать не нужно – уходим
+            return;
+        }
+
+        // контент, который отдает dev-сервер
+        const content = '<h1>Hello, World!</h1>';
+
+        // создаем сервер и начинаем слушать порт 3000
+        http
+            .createServer((req, res) => res.end(content))
+            .listen(3000);
+
+        // по адресу http://localhost:3000/index.html будет отдаваться: <h1>Hello, World!</h1>
+    });
+};
+```
+
+**Конфиг testplane**
+
+```javascript
+module.exports = {
+    // тесты будут запускаться в локальном браузере,
+    // см. про selenium-standalone в разделе «Быстрый старт»
+    gridUrl: "http://localhost:4444/wd/hub",
+    // указываем путь к dev-серверу
+    baseUrl: "http://localhost:3000",
+
+    browsers: {
+        chrome: {
+            desiredCapabilities: {
+                browserName: "chrome",
+            },
+        },
+    },
+
+    plugins: {
+        // добавляем наш плагин к списку плагинов
+        "testplane-dev-server": {
+            enabled: true,
+            // по умолчанию dev-сервер запускаться не будет
+            devServer: false,
+        },
+    },
+};
+```
+
+**Код теста**
+
+```javascript
+const { assert } = require("chai");
+
+describe("example", async () => {
+    it("should find hello world", async ({ browser }) => {
+        // baseUrl, относительно которого задается index.html,
+        // указан в конфиге testplane выше
+        await browser.url("index.html");
+
+        const title = await browser.$("h1").getText();
+        assert.equal(title, "Hello, World!");
+    });
+});
+```
+
+</details>
+
+### Запуск тестов с хелперами {#usage_running_tests_with_helpers}
+
+Рассмотрим [реализацию][testplane-passive-browsers-index] плагина [testplane-passive-browsers][testplane-passive-browsers].
+
+Используя события [BEFORE_FILE_READ](#before_file_read) и [AFTER_TESTS_READ](#after_tests_read) плагин позволяет добавить специальный хелпер, с помощью которого можно запускать указанные тесты или наборы тестов _(suites)_ в заданных браузерах. Такая логика может пригодиться, если вам не нужно запускать большинство тестов в каких-то браузерах. Но при этом некоторые тесты вы все же хотели бы запускать в этих (пассивных) браузерах, чтобы проверять браузеро-специфичные вещи.
+
+В примере ниже мы немного упростили код плагина, задав название хелпера `also` непосредственно в коде, а не беря его из конфига плагина.
+
+В этом примере используются следующие события testplane:
+
+-   [BEFORE_FILE_READ](#before_file_read)
+-   [AFTER_TESTS_READ](#after_tests_read)
+
+Также используются [testParser](#test_parser) и [testCollection][test-collection].
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+**Код плагина**
+
+```javascript
+const _ = require("lodash");
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled) {
+        // плагин отключен – уходим
+        return;
+    }
+
+    if (testplane.isWorker()) {
+        testplane.on(testplane.events.BEFORE_FILE_READ, ({ testParser }) => {
+            // в воркерах хелпер ничего делать не будет,
+            // задаем для него "no operation"
+            testParser.setController("also", { in: _.noop });
+        });
+
+        return;
+    }
+
+    const suitesToRun = {};
+    const testsToRun = {};
+
+    testplane.on(testplane.events.BEFORE_FILE_READ, ({ testParser }) => {
+        testParser.setController("also", {
+            // matcher – параметр, который передается в хелпер also.in();
+            // может быть строкой, регулярным выражением или массивом строк/regexp;
+            // в нашем случае matcher определяет пассивные браузеры,
+            // в которых нужно запустить тест (тесты)
+            in: function (matcher) {
+                const storage = this.suites ? suitesToRun : testsToRun;
+
+                if (!shouldRunInBro(this.browserId, matcher)) {
+                    // если текущего браузера нет в том списке,
+                    // который указан в хелпере, то ничего не делаем
+                    return;
+                }
+
+                if (!storage[this.browserId]) {
+                    storage[this.browserId] = [];
+                }
+
+                // иначе собираем айдишники тестов,
+                // которые должны быть запущены для текущего браузера
+                storage[this.browserId].push({ id: this.id() });
+            },
+        });
+    });
+
+    // используем prependListener, чтобы изначально включить тесты только
+    // в указанных пассивных браузерах, а затем уже будут включены все остальные тесты,
+    // которые должны быть включены
+    testplane.prependListener(testplane.events.AFTER_TESTS_READ, testCollection => {
+        // формируем список пассивных браузеров как пересечение браузеров для тестов,
+        // которые были прочитаны, и браузеров из конфига плагина
+        const passiveBrowserIds = getPassiveBrowserIds(testCollection, pluginConfig);
+
+        passiveBrowserIds.forEach(passiveBrowserId => {
+            const shouldRunTest = (runnable, storage = testsToRun) => {
+                const foundRunnable =
+                    runnable.id && _.find(storage[passiveBrowserId], { id: runnable.id() });
+
+                return (
+                    foundRunnable ||
+                    (runnable.parent && shouldRunTest(runnable.parent, suitesToRun))
+                );
+            };
+
+            // отключаем все тесты, кроме тех, что должны быть запущены
+            // в указанных пассивных браузерах
+            testCollection.eachTest(browserId, test => {
+                test.disabled = !shouldRunTest(test);
+            });
+        });
+    });
+};
+```
+
+**Код теста**
+
+```javascript
+testplane.also.in("ie6");
+describe("suite", () => {
+    it("test1", function () {
+        // ...
+    });
+
+    testplane.also.in(["ie7", /ie[89]/]);
+    it("test2", function () {
+        // ...
+    });
+});
+```
+
+</details>
+
+### Профилирование прогона тестов {#usage_profiling_tests_runs}
+
+Рассмотрим схематичную реализацию профилирования прогона тестов. При каждом запуске теста мы будем засекать время его запуска, а при завершении — время завершения. Всю информацию мы будем сохранять в стрим, который по завершению раннера будет закрываться.
+
+<details>
+
+<summary>
+Нажмите, чтобы посмотреть код
+
+</summary>
+
+```javascript
+const parseConfig = require("./lib/config");
+const StreamWriter = require("./lib/stream-writer");
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled) {
+        // плагин отключен – уходим
+        return;
+    }
+
+    let writeStream;
+
+    testplane.on(testplane.events.RUNNER_START, () => {
+        // создаем стрим для записи данных профилирования
+        writeStream = StreamWriter.create(pluginConfig.path);
+    });
+
+    testplane.on(testplane.events.TEST_BEGIN, test => {
+        if (test.pending) {
+            // тест отключен – ничего делать не нужно
+            return;
+        }
+
+        // засекаем время запуска теста
+        test.timeStart = Date.now();
+    });
+
+    testplane.on(testplane.events.TEST_END, test => {
+        if (test.pending) {
+            // тест отключен – ничего делать не нужно
+            return;
+        }
+
+        // засекаем время завершения теста
+        test.timeEnd = Date.now();
+        // и сохраняем информацию о тесте в стрим
+        writeStream.write(test);
+    });
+
+    // в случае ошибки закрываем стрим
+    testplane.on(testplane.events.ERROR, () => writeStream.end());
+
+    // после завершения раннера закрываем стрим
+    testplane.on(testplane.events.RUNNER_END, () => writeStream.end());
+};
+```
+
+</details>
+
+Более подробную [реализацию][testplane-profiler-index] можно посмотреть в плагине [testplane-profiler][testplane-profiler].
+
+[process-send]: https://nodejs.org/docs/latest-v12.x/api/process.html#process_process_send_message_sendhandle_options_callback
+[test-collection]: ./testplane-api#test_collection
+[disable-all]: ./testplane-api#test_collection_disable_all
+[enable-test]: ./testplane-api#test_collection_enable_test
+[run]: ./testplane-api#testplane_run
+[read-tests]: ./testplane-api#testplane_read_tests
+[testplane-passive-browsers-index]: https://github.com/gemini-testing/testplane-passive-browsers/blob/master/lib/index.js
+[testplane-passive-browsers]: https://github.com/gemini-testing/testplane-passive-browsers
+[testplane-global-hook-index]: https://github.com/gemini-testing/testplane-global-hook/blob/master/index.js
+[testplane-global-hook]: https://github.com/gemini-testing/testplane-global-hook
+[testplane-test-filter]: https://github.com/gemini-testing/testplane-test-filter
+[testplane-test-filter-index]: https://github.com/gemini-testing/testplane-test-filter/blob/master/lib/index.js
+[json-reporter]: https://github.com/gemini-testing/json-reporter
+[json-reporter-index]: https://github.com/gemini-testing/json-reporter/blob/master/testplane.js
+[commander]: https://github.com/gemini-testing/commander.js
+[commander-options]: https://github.com/tj/commander.js#options
+[cli-wiki]: https://ru.wikipedia.org/wiki/Интерфейс_командной_строки
+[testplane-run]: ./testplane-api#testplane_run
+[system]: ../config/system
+[system-workers]: ../config/system#workers
+[system-tests-per-worker]: ../config/system#tests_per_worker
+[browser-tests-per-session]: ../config/browsers#tests_per_session
+[browser-sessions-per-browser]: ../config/browsers#sessions_per_browser
+[skip-in]: ../guides/how-to-skip-test-in-browsers
+[sigterm]: https://ru.wikipedia.org/wiki/Сигнал_(Unix)
+[testplane-test-repeater-index]: https://github.com/gemini-testing/testplane-test-repeater/blob/master/lib/index.js
+[testplane-test-repeater]: https://github.com/gemini-testing/testplane-test-repeater
+[express]: https://github.com/expressjs/express
+[ssh-tunneler]: https://github.com/gemini-testing/ssh-tunneler
+[ssh-tunneler-index]: https://github.com/gemini-testing/ssh-tunneler/blob/master/testplane.js
+[testplane-image-minifier]: https://github.com/gemini-testing/testplane-image-minifier
+[testplane-image-minifier-index]: https://github.com/gemini-testing/testplane-image-minifier/blob/master/lib/index.js
+[testplane-profiler]: https://github.com/gemini-testing/testplane-profiler
+[testplane-profiler-index]: https://github.com/gemini-testing/testplane-profiler/blob/master/index.js
+[hermione-hide-scrollbars]: https://github.com/gemini-testing/hermione-hide-scrollbars
+[hermione-hide-scrollbars-index]: https://github.com/gemini-testing/hermione-hide-scrollbars/blob/master/index.js
+[vnc]: https://ru.wikipedia.org/wiki/Virtual_Network_Computing
+[browsers-retry]: ../config/browsers#retry
+[browsers-should-retry]: ../config/browsers#should_retry
+[retry-limiter]: ../plugins/retry-limiter
+[testplane-retry-progressive]: ../plugins/testplane-retry-progressive
+[error-object]: https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Error
diff --git a/docs/reference/webdriver-vs-cdp.mdx b/docs/reference/webdriver-vs-cdp.mdx
new file mode 100644
index 0000000..1251d34
--- /dev/null
+++ b/docs/reference/webdriver-vs-cdp.mdx
@@ -0,0 +1,90 @@
+# Протоколы общения с браузером: Webdriver vs Chrome DevTools Protocol
+
+## Обзор
+
+В мире автоматического тестирования интерфейсов сейчас наиболее популярны следующие протоколы для управления браузером: [WebDriver][webdriver] и [Chrome DevTools Protocol (CDP)][cdp].
+
+## WebDriver
+
+[WebDriver][webdriver] — это стандартизованный REST API протокол. Разработчики браузеров поддерживают данный протокол в своих драйверах — [chromedriver][chromedriver], [geckodriver][geckodriver], и т. п., — которые являются посредниками (прокси) между клиентом, отправляющим запросы, и самими браузерами. Такой посредник нужен, так как браузеры написаны совершенно по-разному и общение между драйвером и браузером никак не стандартизированно.
+
+Кроме этого, WebDriver-протокол используется в качестве базового протокола для автоматизации мобильных устройств на _iOS/Android_ с использованием [Appium][appium].
+
+![WebDriver-протокол](/img/docs/reference/webdriver-vs-cdp.webdriver-protocol.png)
+
+### Плюсы
+
+-   официальный стандарт, который поддерживается всеми популярными браузерами;
+-   поддержка автоматизации на мобильных устройствах;
+-   может быть использован как на локальной машине, так и на удаленной;
+
+### Минусы
+
+-   из коробки не позволяет отслеживать и перехватывать сетевые события (мок запросов/ответов);
+-   ограниченный набор возможностей для автоматизации (например, нет возможности управлять пропускной способностью сети или производительностью CPU): протокол охватывает только основные пользовательские сценарии взаимодействия с браузером;
+-   нет возможности подписаться на браузерные события (например, получить информацию от браузера, что открылась новая вкладка);
+-   нужны дополнительные «пляски с бубном» для работы (установка _selenium-standalone,_ необходимых драйверов к браузерам и т. п.).
+
+## CDP
+
+[Chrome DevTools Protocol (CDP)][cdp] — это по сути [JSON RPC][json-rpc], реализованный через [вебсокеты][websockets].
+
+_Chrome_ и _Node.js_ реализуют API к этому протоколу, с помощью которого общаться с _DevTools:_ посылать команды, подписываться на события и т.д.
+
+Данный API используется:
+
+-   в _Chrome DevTools_ (панель разработчика внутри браузера) для отлаживания и инспектирования кода;
+-   в IDE (например, в _VSCode)_ — для аналогичных целей;
+-   в различных инструментах автоматизации тестирования: [puppeteer][puppeteer], [cypress][cypress], и пр.;
+-   при общении между [chromedriver][chromedriver] и браузером Chrome (на картинке выше — `browser protocol`).
+
+API протокола поделено логическим образом на домены, которые содержат методы и могут посылать события.
+
+Например, домен [Runtime][cdp-runtime] позволяет инспектировать состояние JavaScript, а с помощью домена [Debugger][debugger] можно отлаживать JavaScript.
+
+<img
+    src={
+        require("@site/static/img/docs/reference/webdriver-vs-cdp.chrome-devtools-protocol.png")
+            .default
+    }
+    width="434"
+    height="200"
+/>
+
+### Плюсы
+
+-   предоставляет больше возможностей для автоматизации, чем Webdriver; с помощью CDP можно:
+    -   [отслеживать и перехватывать сетевые запросы и ответы][how-to-intercept-requests-and-responses]
+    -   [тестировать доступность (accessibility) страницы][how-to-check-accessibility]
+    -   [управлять пропускной способностью сети][how-to-manage-network-bandwidth]
+    -   [управлять быстродействием процессора][how-to-manage-cpu-performance]
+    -   [скрывать скроллбары][how-to-hide-scrollbars-by-cdp]
+    -   и т. д.
+-   не нужно настраивать _selenium-standalone_ или драйверы к браузерам: достаточно иметь локальный Chrome-браузер.
+
+### Минусы
+
+-   поддерживает ограниченный список браузеров: _Chrome, Chromium Edge и Firefox nightly;_
+-   по умолчанию работает только локально (но есть возможность подключиться к уже поднятому браузеру на удаленной машине).
+
+## Полезные ссылки
+
+-   [Как использовать CDP в Testplane][how-to-use-cdp]
+
+[webdriver]: https://www.w3.org/TR/webdriver/
+[cdp]: https://chromedevtools.github.io/devtools-protocol/
+[chromedriver]: https://chromedriver.chromium.org/
+[geckodriver]: https://github.com/mozilla/geckodriver
+[appium]: https://appium.io/
+[json-rpc]: https://ru.wikipedia.org/wiki/JSON-RPC
+[websockets]: https://learn.javascript.ru/websocket
+[puppeteer]: https://pptr.dev/
+[cypress]: https://cypress.io
+[cdp-runtime]: https://chromedevtools.github.io/devtools-protocol/tot/Runtime/
+[debugger]: https://chromedevtools.github.io/devtools-protocol/tot/Debugger/
+[how-to-intercept-requests-and-responses]: ../guides/how-to-intercept-requests-and-responses
+[how-to-check-accessibility]: ../guides/how-to-check-accessibility
+[how-to-manage-network-bandwidth]: ../guides/how-to-manage-network-bandwidth
+[how-to-manage-cpu-performance]: ../guides/how-to-manage-cpu-performance
+[how-to-hide-scrollbars-by-cdp]: ../guides/how-to-hide-scrollbars-by-cdp
+[how-to-use-cdp]: ../guides/how-to-use-cdp
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index 7bc6a0f..ae1d869 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -24,8 +24,8 @@ const config: Config = {
     onBrokenMarkdownLinks: "warn",
 
     i18n: {
-        defaultLocale: "en",
-        locales: ["en"],
+        defaultLocale: "ru",
+        locales: ["en", "ru"],
     },
     headTags: [
         {
@@ -43,6 +43,13 @@ const config: Config = {
                 docs: {
                     sidebarPath: "./sidebars.ts",
                     editUrl: "https://github.com/gemini-testing/testplane-docs/tree/main/docs/",
+                    lastVersion: "current",
+                    versions: {
+                        current: {
+                            label: "v8",
+                            path: "v8",
+                        },
+                    },
                 },
                 blog: {
                     showReadingTime: true,
@@ -94,16 +101,16 @@ const config: Config = {
                     title: "Quickstart",
                     items: [
                         {
-                            label: "Installation",
-                            to: "#",
+                            label: "Overview",
+                            to: "/docs/v8",
                         },
                         {
-                            label: "Writing your first tests",
-                            to: "#",
+                            label: "Installation",
+                            to: "/docs/v8/quickstart",
                         },
                         {
                             label: "Why testplane?",
-                            to: "#",
+                            to: "/docs/v8#why-testplane",
                         },
                     ],
                 },
@@ -112,15 +119,15 @@ const config: Config = {
                     items: [
                         {
                             label: "Browser commands",
-                            href: "#",
+                            href: "/docs/v8/commands/overview",
                         },
                         {
                             label: "Testplane config",
-                            href: "#",
+                            href: "/docs/v8/config/main",
                         },
                         {
                             label: "Testplane UI",
-                            href: "#",
+                            href: "/docs/v8/html-reporter/html-reporter-setup",
                         },
                     ],
                 },
@@ -128,16 +135,16 @@ const config: Config = {
                     title: "Customization",
                     items: [
                         {
-                            label: "Custom commands",
-                            href: "#",
+                            label: "Testplane API",
+                            href: "/docs/v8/reference/hermione-api",
                         },
                         {
-                            label: "Plugins and reporters",
-                            href: "#",
+                            label: "Testplane events",
+                            href: "/docs/v8/reference/testplane-events",
                         },
                         {
-                            label: "Usage in CI",
-                            href: "#",
+                            label: "Plugins",
+                            href: "/docs/v8/guides/how-to-write-your-own-plugin",
                         },
                     ],
                 },
@@ -146,15 +153,15 @@ const config: Config = {
                     items: [
                         {
                             label: "Docs",
-                            href: "#",
+                            href: "/docs/v8",
                         },
                         {
                             label: "Blog",
-                            href: "#",
+                            href: "/blog",
                         },
                         {
                             label: "Changelog",
-                            to: "#",
+                            to: "https://github.com/gemini-testing/testplane/blob/master/CHANGELOG.md",
                         },
                     ],
                 },
diff --git a/i18n/en/code.json b/i18n/en/code.json
new file mode 100644
index 0000000..b3d25db
--- /dev/null
+++ b/i18n/en/code.json
@@ -0,0 +1,313 @@
+{
+    "versionsPage.versionEntry.link": {
+        "message": "Documentation"
+    },
+    "versionsPage.versionEntry.releaseNotes": {
+        "message": "Release Notes"
+    },
+    "versionsPage.title": {
+        "message": "Testplane versions"
+    },
+    "versionsPage.current.title": {
+        "message": "Current version (Stable)"
+    },
+    "versionsPage.current.description": {
+        "message": "Here you can find the documentation for current released version."
+    },
+    "versionsPage.next.title": {
+        "message": "Next version (Unreleased)"
+    },
+    "versionsPage.next.description": {
+        "message": "Here you can find the documentation for work-in-process unreleased version."
+    },
+    "landing.getStartedButton": {
+        "message": "Get started"
+    },
+    "theme.ErrorPageContent.title": {
+        "message": "This page crashed.",
+        "description": "The title of the fallback page when the page crashed"
+    },
+    "theme.BackToTopButton.buttonAriaLabel": {
+        "message": "Scroll back to top",
+        "description": "The ARIA label for the back to top button"
+    },
+    "theme.blog.archive.title": {
+        "message": "Archive",
+        "description": "The page & hero title of the blog archive page"
+    },
+    "theme.blog.archive.description": {
+        "message": "Archive",
+        "description": "The page & hero description of the blog archive page"
+    },
+    "theme.blog.paginator.navAriaLabel": {
+        "message": "Blog list page navigation",
+        "description": "The ARIA label for the blog pagination"
+    },
+    "theme.blog.paginator.newerEntries": {
+        "message": "Newer Entries",
+        "description": "The label used to navigate to the newer blog posts page (previous page)"
+    },
+    "theme.blog.paginator.olderEntries": {
+        "message": "Older Entries",
+        "description": "The label used to navigate to the older blog posts page (next page)"
+    },
+    "theme.blog.post.paginator.navAriaLabel": {
+        "message": "Blog post page navigation",
+        "description": "The ARIA label for the blog posts pagination"
+    },
+    "theme.blog.post.paginator.newerPost": {
+        "message": "Newer Post",
+        "description": "The blog post button label to navigate to the newer/previous post"
+    },
+    "theme.blog.post.paginator.olderPost": {
+        "message": "Older Post",
+        "description": "The blog post button label to navigate to the older/next post"
+    },
+    "theme.blog.post.plurals": {
+        "message": "One post|{count} posts",
+        "description": "Pluralized label for \"{count} posts\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)"
+    },
+    "theme.blog.tagTitle": {
+        "message": "{nPosts} tagged with \"{tagName}\"",
+        "description": "The title of the page for a blog tag"
+    },
+    "theme.tags.tagsPageLink": {
+        "message": "View All Tags",
+        "description": "The label of the link targeting the tag list page"
+    },
+    "theme.colorToggle.ariaLabel": {
+        "message": "Switch between dark and light mode (currently {mode})",
+        "description": "The ARIA label for the navbar color mode toggle"
+    },
+    "theme.colorToggle.ariaLabel.mode.dark": {
+        "message": "dark mode",
+        "description": "The name for the dark color mode"
+    },
+    "theme.colorToggle.ariaLabel.mode.light": {
+        "message": "light mode",
+        "description": "The name for the light color mode"
+    },
+    "theme.docs.breadcrumbs.navAriaLabel": {
+        "message": "Breadcrumbs",
+        "description": "The ARIA label for the breadcrumbs"
+    },
+    "theme.docs.DocCard.categoryDescription.plurals": {
+        "message": "1 item|{count} items",
+        "description": "The default description for a category card in the generated index about how many items this category includes"
+    },
+    "theme.docs.paginator.navAriaLabel": {
+        "message": "Docs pages",
+        "description": "The ARIA label for the docs pagination"
+    },
+    "theme.docs.paginator.previous": {
+        "message": "Previous",
+        "description": "The label used to navigate to the previous doc"
+    },
+    "theme.docs.paginator.next": {
+        "message": "Next",
+        "description": "The label used to navigate to the next doc"
+    },
+    "theme.docs.tagDocListPageTitle.nDocsTagged": {
+        "message": "One doc tagged|{count} docs tagged",
+        "description": "Pluralized label for \"{count} docs tagged\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)"
+    },
+    "theme.docs.tagDocListPageTitle": {
+        "message": "{nDocsTagged} with \"{tagName}\"",
+        "description": "The title of the page for a docs tag"
+    },
+    "theme.docs.versionBadge.label": {
+        "message": "Version: {versionLabel}"
+    },
+    "theme.docs.versions.unreleasedVersionLabel": {
+        "message": "This is unreleased documentation for {siteTitle} {versionLabel} version.",
+        "description": "The label used to tell the user that he's browsing an unreleased doc version"
+    },
+    "theme.docs.versions.unmaintainedVersionLabel": {
+        "message": "This is documentation for {siteTitle} {versionLabel}, which is no longer actively maintained.",
+        "description": "The label used to tell the user that he's browsing an unmaintained doc version"
+    },
+    "theme.docs.versions.latestVersionSuggestionLabel": {
+        "message": "For up-to-date documentation, see the {latestVersionLink} ({versionLabel}).",
+        "description": "The label used to tell the user to check the latest version"
+    },
+    "theme.docs.versions.latestVersionLinkLabel": {
+        "message": "latest version",
+        "description": "The label used for the latest version suggestion link label"
+    },
+    "theme.common.editThisPage": {
+        "message": "Edit this page",
+        "description": "The link label to edit the current page"
+    },
+    "theme.common.headingLinkTitle": {
+        "message": "Direct link to {heading}",
+        "description": "Title for link to heading"
+    },
+    "theme.lastUpdated.atDate": {
+        "message": " on {date}",
+        "description": "The words used to describe on which date a page has been last updated"
+    },
+    "theme.lastUpdated.byUser": {
+        "message": " by {user}",
+        "description": "The words used to describe by who the page has been last updated"
+    },
+    "theme.lastUpdated.lastUpdatedAtBy": {
+        "message": "Last updated{atDate}{byUser}",
+        "description": "The sentence used to display when a page has been last updated, and by who"
+    },
+    "theme.navbar.mobileVersionsDropdown.label": {
+        "message": "Versions",
+        "description": "The label for the navbar versions dropdown on mobile view"
+    },
+    "theme.NotFound.title": {
+        "message": "Page Not Found",
+        "description": "The title of the 404 page"
+    },
+    "theme.tags.tagsListLabel": {
+        "message": "Tags:",
+        "description": "The label alongside a tag list"
+    },
+    "theme.AnnouncementBar.closeButtonAriaLabel": {
+        "message": "Close",
+        "description": "The ARIA label for close button of announcement bar"
+    },
+    "theme.admonition.caution": {
+        "message": "caution",
+        "description": "The default label used for the Caution admonition (:::caution)"
+    },
+    "theme.admonition.danger": {
+        "message": "danger",
+        "description": "The default label used for the Danger admonition (:::danger)"
+    },
+    "theme.admonition.info": {
+        "message": "info",
+        "description": "The default label used for the Info admonition (:::info)"
+    },
+    "theme.admonition.note": {
+        "message": "note",
+        "description": "The default label used for the Note admonition (:::note)"
+    },
+    "theme.admonition.tip": {
+        "message": "tip",
+        "description": "The default label used for the Tip admonition (:::tip)"
+    },
+    "theme.admonition.warning": {
+        "message": "warning",
+        "description": "The default label used for the Warning admonition (:::warning)"
+    },
+    "theme.blog.sidebar.navAriaLabel": {
+        "message": "Blog recent posts navigation",
+        "description": "The ARIA label for recent posts in the blog sidebar"
+    },
+    "theme.CodeBlock.copied": {
+        "message": "Copied",
+        "description": "The copied button label on code blocks"
+    },
+    "theme.CodeBlock.copyButtonAriaLabel": {
+        "message": "Copy code to clipboard",
+        "description": "The ARIA label for copy code blocks button"
+    },
+    "theme.CodeBlock.copy": {
+        "message": "Copy",
+        "description": "The copy button label on code blocks"
+    },
+    "theme.CodeBlock.wordWrapToggle": {
+        "message": "Toggle word wrap",
+        "description": "The title attribute for toggle word wrapping button of code block lines"
+    },
+    "theme.DocSidebarItem.expandCategoryAriaLabel": {
+        "message": "Expand sidebar category '{label}'",
+        "description": "The ARIA label to expand the sidebar category"
+    },
+    "theme.DocSidebarItem.collapseCategoryAriaLabel": {
+        "message": "Collapse sidebar category '{label}'",
+        "description": "The ARIA label to collapse the sidebar category"
+    },
+    "theme.NavBar.navAriaLabel": {
+        "message": "Main",
+        "description": "The ARIA label for the main navigation"
+    },
+    "theme.NotFound.p1": {
+        "message": "We could not find what you were looking for.",
+        "description": "The first paragraph of the 404 page"
+    },
+    "theme.NotFound.p2": {
+        "message": "Please contact the owner of the site that linked you to the original URL and let them know their link is broken.",
+        "description": "The 2nd paragraph of the 404 page"
+    },
+    "theme.navbar.mobileLanguageDropdown.label": {
+        "message": "Languages",
+        "description": "The label for the mobile language switcher dropdown"
+    },
+    "theme.TOCCollapsible.toggleButtonLabel": {
+        "message": "On this page",
+        "description": "The label used by the button on the collapsible TOC component"
+    },
+    "theme.blog.post.readMore": {
+        "message": "Read More",
+        "description": "The label used in blog post item excerpts to link to full blog posts"
+    },
+    "theme.blog.post.readMoreLabel": {
+        "message": "Read more about {title}",
+        "description": "The ARIA label for the link to full blog posts from excerpts"
+    },
+    "theme.blog.post.readingTime.plurals": {
+        "message": "One min read|{readingTime} min read",
+        "description": "Pluralized label for \"{readingTime} min read\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)"
+    },
+    "theme.docs.breadcrumbs.home": {
+        "message": "Home page",
+        "description": "The ARIA label for the home page in the breadcrumbs"
+    },
+    "theme.docs.sidebar.collapseButtonTitle": {
+        "message": "Collapse sidebar",
+        "description": "The title attribute for collapse button of doc sidebar"
+    },
+    "theme.docs.sidebar.collapseButtonAriaLabel": {
+        "message": "Collapse sidebar",
+        "description": "The title attribute for collapse button of doc sidebar"
+    },
+    "theme.docs.sidebar.navAriaLabel": {
+        "message": "Docs sidebar",
+        "description": "The ARIA label for the sidebar navigation"
+    },
+    "theme.docs.sidebar.closeSidebarButtonAriaLabel": {
+        "message": "Close navigation bar",
+        "description": "The ARIA label for close button of mobile sidebar"
+    },
+    "theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": {
+        "message": "← Back to main menu",
+        "description": "The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)"
+    },
+    "theme.docs.sidebar.toggleSidebarButtonAriaLabel": {
+        "message": "Toggle navigation bar",
+        "description": "The ARIA label for hamburger menu button of mobile navigation"
+    },
+    "theme.docs.sidebar.expandButtonTitle": {
+        "message": "Expand sidebar",
+        "description": "The ARIA label and title attribute for expand button of doc sidebar"
+    },
+    "theme.docs.sidebar.expandButtonAriaLabel": {
+        "message": "Expand sidebar",
+        "description": "The ARIA label and title attribute for expand button of doc sidebar"
+    },
+    "theme.ErrorPageContent.tryAgain": {
+        "message": "Try again",
+        "description": "The label of the button to try again rendering when the React error boundary captures an error"
+    },
+    "theme.common.skipToMainContent": {
+        "message": "Skip to main content",
+        "description": "The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation"
+    },
+    "theme.tags.tagsPageTitle": {
+        "message": "Tags",
+        "description": "The title of the tag list page"
+    },
+    "theme.unlistedContent.title": {
+        "message": "Unlisted page",
+        "description": "The unlisted content banner title"
+    },
+    "theme.unlistedContent.message": {
+        "message": "This page is unlisted. Search engines will not index it, and only users having a direct link can access it.",
+        "description": "The unlisted content banner message"
+    }
+}
diff --git a/i18n/en/docusaurus-plugin-content-blog/options.json b/i18n/en/docusaurus-plugin-content-blog/options.json
new file mode 100644
index 0000000..159eb3b
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-blog/options.json
@@ -0,0 +1,14 @@
+{
+    "title": {
+        "message": "Blog",
+        "description": "The title for the blog used in SEO"
+    },
+    "description": {
+        "message": "Blog",
+        "description": "The description for the blog used in SEO"
+    },
+    "sidebar.title": {
+        "message": "Recent posts",
+        "description": "The label for the left sidebar"
+    }
+}
diff --git a/i18n/en/docusaurus-plugin-content-docs/current.json b/i18n/en/docusaurus-plugin-content-docs/current.json
new file mode 100644
index 0000000..da01697
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current.json
@@ -0,0 +1,18 @@
+{
+    "version.label": {
+        "message": "v8",
+        "description": "The label for version current"
+    },
+    "sidebar.mainSidebar.category.Config": {
+        "message": "Config",
+        "description": "The label for category Config in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.HTML Reporter": {
+        "message": "HTML Reporter",
+        "description": "The label for category HTML Reporter in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.Plugins": {
+        "message": "Plugins",
+        "description": "The label for category Plugins in sidebar mainSidebar"
+    }
+}
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/config/browsers.mdx b/i18n/en/docusaurus-plugin-content-docs/current/config/browsers.mdx
new file mode 100644
index 0000000..dae36b2
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/config/browsers.mdx
@@ -0,0 +1,653 @@
+import Admonition from "@theme/Admonition";
+
+# browsers
+
+## Overview {#overview}
+
+The `browsers` section is required in Testplane settings. It specifies all the browsers in which the tests will be run.
+
+## Setup {#setup}
+
+This section has the following format:
+
+```javascript
+module.exports = {
+    browsers: {
+        "<browser-id>": {
+            "<option>": "<value>",
+            "<option>": "<value>",
+
+            // other browser settings...
+        },
+
+        // other browsers...
+    },
+
+    // other testplane settings...
+};
+```
+
+Where `<browser-id>` is the browser name that is used to identify it.
+
+In order not to repeat the same settings for different browsers, you can set all the default values you need in the root of testplane config. For example:
+
+```javascript
+module.exports = {
+    sessionsPerBrowser: 10,
+    browsers: {
+        chrome: {
+            // the parameter "sessionsPerBrowser" is not specified,
+            // therefore, the value 10 from the config root will be used
+        },
+
+        firefox: {
+            sessionsPerBrowser: 5, // and firefox will use the value 5
+        },
+    },
+
+    // other testplane settings...
+};
+```
+
+Further, all browser settings are divided logically into sections, so that it is easier to navigate among them.
+
+## Browser and its properties {#browser_main_settings}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[desiredCapabilities](#desired_caps)</td><td>Object</td><td>_N/A_</td><td>Required parameter. Defines the properties that the browser should have. Used by _WebDriver_, see [DesiredCapabilities][desired-caps].</td></tr>
+<tr><td>[gridUrl](#grid_url)</td><td>String</td><td>"http://localhost:4444/wd/hub"</td><td>URL of the Selenium grid.</td></tr>
+<tr><td>[baseUrl](#base_url)</td><td>String</td><td>"http://localhost"</td><td>The base URL of the service under test.</td></tr>
+<tr><td>[browserWSEndpoint](#browser_ws_endpoint)</td><td>String</td><td>null</td><td>The endpoint of WebSocket to connect to the browser by [Chrome DevTools Protocol (CDP)][how-to-use-cdp].</td></tr>
+<tr><td>[automationProtocol](#automation_protocol)</td><td>String</td><td>"webdriver"</td><td>Protocol of communication with the browser. See [WebDriver vs CDP][webdriver-vs-cdp].</td></tr>
+<tr><td>[sessionEnvFlags](#session_env_flags)</td><td>Object</td><td>`{ }`</td><td>Environment flags specifying the protocol to be used in the created browser session.</td></tr>
+<tr><td>[windowSize](#window_size)</td><td>String or Object</td><td>null</td><td>The size of the browser window.</td></tr>
+
+</tbody>
+</table>
+
+### desiredCapabilities {#desired_caps}
+
+Required parameter. Defines the properties that the browser should have. Used by _WebDriver_, see [DesiredCapabilities][desired-caps]. For example:
+
+```javascript
+module.exports = {
+    browsers: {
+        chrome: {
+            desiredCapabilities: {
+                browserName: "chrome",
+                version: "75.0", // or "browserVersion", if the browser supports W3C
+                chromeOptions: {
+                    // ...
+                },
+            },
+        },
+
+        // other browsers settings...
+    },
+
+    // other testplane settings...
+};
+```
+
+### gridUrl {#grid_url}
+
+URL of the Selenium grid. By default: `http://localhost:4444/wd/hub`.
+
+### baseUrl {#base_url}
+
+The base URL of the service under test. By default: `http://localhost`.
+
+### browserWSEndpoint {#browser_ws_endpoint}
+
+The endpoint of WebSocket to connect to the browser by [Chrome DevTools Protocol (CDP)][how-to-use-cdp]. For example, you specify `browserWSEndpoint: "ws://YOUR_HOST/devtools"`, to which the browser session ID will be added at the end: `ws://YOUR_HOST/devtools/12345`, where `12345` is session ID.
+
+### automationProtocol {#automation_protocol}
+
+Protocol of communication with the browser. Available values: `webdriver` and `devtools`. See also [WebDriver vs CDP][webdriver-vs-cdp]. By default: `webdriver`.
+
+### sessionEnvFlags {#session_env_flags}
+
+The environment flags specify the protocols to be used in the created browser session. By default, the environment flags are automatically set according to the specified `desiredCapabilities`. However, in rare cases they can take incorrect values so that you can set them explicitly by this option.
+
+Available flags:
+
+<table>
+<thead>
+<tr><td>**Flag**</td><td>**Protocols**</td></tr>
+</thead>
+<tbody>
+<tr><td>isW3C</td><td>[WebDriverProtocol](https://webdriver.io/docs/api/webdriver) or by default [JsonWProtocol](https://webdriver.io/docs/api/jsonwp)</td></tr>
+<tr><td>isChrome</td><td>[ChromiumProtocol](https://webdriver.io/docs/api/chromium)</td></tr>
+<tr><td>isMobile</td><td>[MJsonWProtocol](https://webdriver.io/docs/api/mjsonwp) and [AppiumProtocol](https://webdriver.io/docs/api/appium)</td></tr>
+<tr><td>isSauce</td><td>[Commands of a specific Sauce Labs vendor](https://webdriver.io/docs/api/saucelabs)</td></tr>
+<tr><td>isSeleniumStandalone</td><td>[Special commands for Selenium](https://webdriver.io/docs/api/selenium) when running tests in _Selenium Grid_ or using _Selenium Standalone Server_.</td></tr>
+
+</tbody>
+</table>
+
+For example:
+
+```javascript
+module.exports = {
+    browsers: {
+        chrome: {
+            sessionEnvFlags: {
+                isW3C: true,
+                isChrome: true,
+            },
+        },
+
+        // other browsers settings...
+    },
+
+    // other testplane settings...
+};
+```
+
+### windowSize {#window_size}
+
+The size of the browser window. If not specified, the window size will depend on the WebDriver. It can be specified as a string, for example, `800x1000` or as an object with the keys `width` and `height`, the values of which must be specified as integers.
+
+For example:
+
+```javascript
+windowSize: "800x1000";
+```
+
+and
+
+```javascript
+windowSize: {
+  width: 800,
+  height: 1000
+}
+```
+
+are equivalent to each other.
+
+<Admonition type="warning">
+    Setting the resolution for the Opera browser or for mobile browsers does not work. Since these
+    browsers only use fullscreen mode.
+</Admonition>
+
+## Timeouts {#timeouts}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[waitTimeout](#wait_timeout)</td><td>Number</td><td>3000</td><td>Timeout for events on a web page, in ms.</td></tr>
+<tr><td>[waitInterval](#wait_interval)</td><td>Number</td><td>500</td><td>Interval for events on a web page, in ms.</td></tr>
+<tr><td>[httpTimeout](#http_timeout)</td><td>Number</td><td>30000</td><td>Timeout for any requests to the Selenium server, in ms.</td></tr>
+<tr><td>[urlHttpTimeout](#url_http_timeout)</td><td>Number</td><td>=&nbsp;_httpTimeout_</td><td>Timeout for the _/url_ request to the Selenium server, in ms.</td></tr>
+<tr><td>[pageLoadTimeout](#page_load_timeout)</td><td>Number</td><td>20000</td><td>Timeout for full page loading, in ms.</td></tr>
+<tr><td>[sessionRequestTimeout](#session_request_timeout)</td><td>Number</td><td>=&nbsp;_httpTimeout_</td><td>Browser session request timeout, in ms.</td></tr>
+<tr><td>[sessionQuitTimeout](#session_quit_timeout)</td><td>Number</td><td>5000</td><td>Timeout to end the session, in ms.</td></tr>
+<tr><td>[testTimeout](#test_timeout)</td><td>Number</td><td>null</td><td>Timeout for the test run, in ms. If the value is not set, a common timeout for all browsers will be used, which is set by the setting [system.mochaOpts.timeout][system-mocha-opts].</td></tr>
+
+</tbody>
+</table>
+
+### waitTimeout {#wait_timeout}
+
+Timeout for events on a web page, in ms. By default: `3000` ms (3 seconds).
+
+It is used in the [waitUntil][element-wait-until] command, which is used in all `waitFor*` commands when searching for a given element on the page.
+
+For example, when executing the command `browser.$('.element').click()` the subcommand `$('element')` will by default wait for the element to exist for up to 3000 ms before clicking on it.
+
+### waitInterval {#wait_interval}
+
+Interval for events on a web page, in ms. By default: `500` ms.
+
+It is used in the [waitUntil][element-wait-until] command, which is used in all `waitFor*` commands when searching for a given element on the page.
+
+For example, when executing the command `browser.$('.element').click()` the subcommand `$('element')` will by default check the existence of an element every 500 ms.
+
+### httpTimeout {#http_timeout}
+
+Timeout for any requests to the Selenium server, in ms. By default: `30000` ms.
+
+### urlHttpTimeout {#url_http_timeout}
+
+Timeout for the `/url` request to the Selenium server, in ms. Sometimes when opening a link on the server side, a lot of logic is performed in the middlewares, which is why the link takes a long time to open. In order not to raise the timeout for all commands because of this, testplane allows you to set up a separate timeout for the request `/url`.
+
+### pageLoadTimeout {#page_load_timeout}
+
+Timeout for full page loading, in ms. By default: `20000` ms.
+
+### sessionRequestTimeout {#session_request_timeout}
+
+Browser session request timeout, in ms. By default, it takes the setting value `httpTimeout`.
+
+### sessionQuitTimeout {#session_quit_timeout}
+
+Timeout to end the session, in milliseconds. By default: `5000` ms.
+
+### testTimeout {#test_timeout}
+
+Timeout for the test run, in milliseconds. When used for a test suite, will be applied to all tests and hooks inside this test suite.
+
+If the value is not set, a common timeout for all browsers will be used, which is set by the [system.mochaOpts.timeout][system-mocha-opts] setting.
+
+## Running tests {#test_run_settings}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;values**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[sessionsPerBrowser](#sessions_per_browser)</td><td>Number</td><td>1</td><td>The number of sessions that will be started simultaneously for a particular browser.</td></tr>
+<tr><td>[testsPerSession](#tests_per_session)</td><td>Number</td><td>_N/A_</td><td>How many tests can be run sequentially in one browser session. The parameter restricts session reuse in order to prevent tests from failing due to browser degradation, and has nothing to do with running tests in parallel.</td></tr>
+<tr><td>[retry](#retry)</td><td>Number</td><td>0</td><td>How many times you need to restart the failing test.</td></tr>
+<tr><td>[shouldRetry](#should_retry)</td><td>Function</td><td>_see description_</td><td>A function that determines whether a retry is needed. By default, a function is set that returns _true_, if _retry > 0,_ and _false_, if _retry == 0_.</td></tr>
+<tr><td>[strictTestsOrder](#strict_test_order)</td><td>Boolean</td><td>false</td><td>Guarantee a strict order of tests. If _true_, then the API function _testplane.readTests_ will always return the same result.</td></tr>
+
+</tbody>
+</table>
+
+### sessionsPerBrowser {#sessions_per_browser}
+
+The number of sessions to be started simultaneously for a particular browser. By default: `1`.
+
+### testsPerSession {#tests_per_session}
+
+This parameter determines how many tests can be run sequentially in one browser session. It may be useful to limit session reuse. If the same browser session is used many times to run various tests, then at some point the browser may begin to degrade. And this will begin to affect the tests runs, leading to their failures. After the limit of tests is reached, the session will be closed and a new session will start.
+
+By default: `Infinity`. That is, the session will be reused an infinite number of times. However, in real operation, there may be restrictions on the part of the grid within which browsers are launched. For example, the grid can limit the maximum lifetime of one session, and then the number of tests that will be performed within one session will be determined by its lifetime.
+
+<Admonition type="warning">
+    Pay attention: this parameter has nothing to do with running tests in parallel.
+</Admonition>
+
+### retry {#retry}
+
+How many times you need to run the test again if it crashes. By default: `0`.
+
+### shouldRetry {#should_retry}
+
+A function that determines whether a retry is needed. Must return a value of type `Boolean`. By default, a function is set that returns `true` if there are still available retries, and `false` if the limit of retries for the test is reached (see setting [retry](#retry)).
+
+The argument of this function is an object with the following fields:
+
+<table>
+<thead>
+<tr><td>ctx</td><td>Object</td><td>Data about the failed test: _\{ id(): string; browserId: string; sessionId: string; }_.</td></tr>
+</thead>
+<tbody>
+<tr><td>retriesLeft</td><td>Number</td><td>Number of remaining retries.</td></tr>
+
+</tbody>
+</table>
+
+### strictTestsOrder {#strict_test_order}
+
+This option enables a guarantee of a strict order of reading tests. By default: `false`.
+
+## Information about the test and its failure {#info_when_test_fails}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[meta](#meta)</td><td>Object</td><td>_N/A_</td><td>Additional data to be returned by the command _getMeta()_.</td></tr>
+<tr><td>[takeScreenshotOnFails](#take_screenshot_on_fails)</td><td>Object</td><td>_see description_</td><td>Determines whether to take a screenshot of the browser page _(Page Screenshot)_ when the test fails, as well as when the _assertView_ command fails. Default value: _\{ testFail: true, assertViewFail: true }_.</td></tr>
+<tr><td>[takeScreenshotOnFailsMode](#take_screenshot_on_fails_mode)</td><td>String</td><td>"fullpage"</td><td>The mode of taking a screenshot when the test fails. Available values: _viewport_ and _fullpage_.</td></tr>
+<tr><td>[takeScreenshotOnFailsTimeout](#take_screenshot_on_fails_timeout)</td><td>Number</td><td>5000</td><td>Timeout for taking a screenshot of the browser page _(Page Screenshot)_ when the test fails, in ms.</td></tr>
+<tr><td>[saveHistory](#save_history)</td><td>Boolean</td><td>true</td><td>Save the history of all executed commands. _Replaced to `saveHistoryMode` in hermione@7_.</td></tr>
+<tr><td>[saveHistoryMode](#save_history_mode)</td><td>"all" or "none" or "onlyFailed"</td><td>"all"</td><td>Save the history of all executed commands. _Available from hermione@7_.</td></tr>
+
+</tbody>
+</table>
+
+### meta {#meta}
+
+Additional data that will be returned by the `getMeta()` command. Data can also be added "on the fly" using the `setMeta()` command: before, during, or after the test run is completed.
+
+### takeScreenshotOnFails {#take_screenshot_on_fails}
+
+The option is set as an object with two keys: `testFail` and `assertViewFail`. These keys determine whether to take a screenshot of the browser page _(Page Screenshot)_ when the test fails and when the `assertView` command fails, respectively. Default value: `{ testFail: true, assertViewFail: true }`. In the case of `testFail`, all test failures are taken into account, except for failures due to `assertView` commands.
+
+### takeScreenshotOnFailsMode {#take_screenshot_on_fails_mode}
+
+The mode of taking a screenshot of the browser page when the test fails. Available values are `viewport` and `fullpage`:
+
+-   `viewport`—take a screenshot of the current viewport.
+-   `fullpage`—take a screenshot of the entire browser page.
+
+By default: `fullpage`.
+
+### takeScreenshotOnFailsTimeout {#take_screenshot_on_fails_timeout}
+
+Timeout for taking a screenshot of the browser page when the test fails, in milliseconds. By default: `5000` ms.
+
+### saveHistory {#save_history}
+
+<Admonition type="warning">
+    Replaced to [saveHistoryMode](#save_history_mode) in hermione@7.
+</Admonition>
+
+Save the history of all executed commands. By default: `true`.
+
+Some plugins may rely on this history, for example, [html-reporter][html-reporter].
+
+The history is available from the following events—`TEST_END`, `TEST_PASS`, `TEST_FAIL`—via `payload`:
+
+```javascript
+// sample plugin code
+module.exports = testplane => {
+    testplane.on(testplane.events.TEST_PASS, async test => {
+        console.log(test.history);
+    });
+};
+```
+
+### saveHistoryMode {#save_history_mode}
+
+<Admonition type="warning">Available from hermione@7.</Admonition>
+
+Save the history of all executed commands. By default: `all`.
+
+Available options:
+
+-   `all` — history is enabled.
+-   `none` — history is disabled
+-   `onlyFailed` — history is saved for failed tests only.
+
+Some plugins may rely on this history, for example, [html-reporter][html-reporter].
+
+The history is available from the following events—`TEST_END`, `TEST_PASS`, `TEST_FAIL`—via `payload`:
+
+```javascript
+// sample plugin code
+module.exports = testplane => {
+    testplane.on(testplane.events.TEST_PASS, async test => {
+        console.log(test.history);
+    });
+};
+```
+
+## Preparing to take screenshots {#prepare_to_take_screenshot}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[calibrate](#calibrate)</td><td>Boolean</td><td>false</td><td>Perform calibration before taking a screenshot.</td></tr>
+<tr><td>[orientation](#orientation)</td><td>String</td><td>null</td><td>The orientation of the browser window that you need to set before running each test.</td></tr>
+<tr><td>[waitOrientationChange](#wait_orientation_change)</td><td>Boolean</td><td>true</td><td>Wait for a real change of orientation.</td></tr>
+<tr><td>[resetCursor](#reset_cursor)</td><td>Boolean</td><td>true</td><td>Move the cursor to the point _(0, 0)_ in _body_ coordinates before each test run.</td></tr>
+<tr><td>[screenshotsDir](#screenshots_dir)</td><td>String</td><td>"./testplane/screens"</td><td>Folder for saving reference screenshots by _assertView_ command. Default value is _"testplane/screens"_ relative to the working folder: _process.cwd()_.</td></tr>
+
+</tbody>
+</table>
+
+### calibrate {#calibrate}
+
+Perform calibration before taking a screenshot. In some WebDriver implementations, when taking a screenshot, the UI elements of the browser itself may be captured too. Calibration allows you to solve this problem. By default: `false`.
+
+### orientation {#orientation}
+
+The orientation of the browser window that you need to set before running each test. Available values: `landscape`, `portrait`, `null`. By default: `null`.
+
+<Admonition type="tip" title="What value should I choose for orientation?">
+    It depends on which orientation you are running most of the tests in. If most of your tests are
+    performed in _landscape_ mode, then the _orientation_ value should be set to _landscape._ Then
+    the tests that need the _portrait_ orientation will individually set the orientation they need.
+    And the _orientation_ option will ensure that for all other tests, the orientation will be set
+    to _landscape_ automatically before they run, without having to set it in each test
+    individually.
+</Admonition>
+
+### waitOrientationChange {#wait_orientation_change}
+
+Wait for a real change of orientation. By default: `true`. When set to `true`, testplane guarantees that the command `setOrientation` will be completed only after the orientation is actually changed to the specified one.
+
+### resetCursor {#reset_cursor}
+
+Move the cursor to the point _(0, 0)_ in _body_ coordinates before each test run. By default: `true`. It may be required in cases where the default cursor position affects the execution of tests. For example, when some hint pops up from behind the cursor, which "spoils" the screenshot being taken.
+
+<Admonition type="tip">
+    It is recommended to reset the cursor for desktop browsers and not to reset it for mobile.
+</Admonition>
+
+### screenshotsDir {#screenshots_dir}
+
+Folder for saving reference screenshots with the `assertView` command. By default, this is the `testplane/screens` folder relative to the working folder: `process.cwd()`. The value of this option can also be a function. The test instance in which `assertView` command was called is passed to the function as a single argument. For example:
+
+```javascript
+screenshotsDir: test => `tests/screenshots/${test.parent.title}`;
+```
+
+## Taking and comparing screenshots {#taking_screenshots}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Defaultо&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[tolerance](#tolerance)</td><td>Number</td><td>2.3</td><td>Maximum allowed difference between colors: [CIEDE2000](http://en.wikipedia.org/wiki/Color_difference#CIEDE2000).</td></tr>
+<tr><td>[antialiasingTolerance](#antialiasing_tolerance)</td><td>Number</td><td>4</td><td>Sets the sensitivity of the antialiasing definition, which will be ignored when comparing screenshots.</td></tr>
+<tr><td>[compareOpts](#compare_opts)</td><td>Object</td><td>_[see below](#compare_opts)_</td><td>Options for comparing images.</td></tr>
+<tr><td>[buildDiffOpts](#build_diff_opts)</td><td>Object</td><td>_[see below](#build_diff_opts)_</td><td>Options for building a diff (an image with a difference between screenshots).</td></tr>
+<tr><td>[assertViewOpts](#assert_view_opts)</td><td>Object</td><td>_[see below](#assert_view_opts)_</td><td>Options for the _assertView_ command to be used by default.</td></tr>
+<tr><td>[compositeImage](#composite_image)</td><td>Boolean</td><td>true</td><td>Allows you to test elements that do not fit into the viewport in height.</td></tr>
+<tr><td>[screenshotMode](#screenshot_mode)</td><td>String</td><td>"auto"</td><td>Screenshot mode. Possible values: _auto, fullpage, viewport_.</td></tr>
+<tr><td>[screenshotDelay](#screenshot_delay)</td><td>Number</td><td>0</td><td>Delay before taking a screenshot, in ms.</td></tr>
+
+</tbody>
+</table>
+
+### tolerance {#tolerance}
+
+Maximum allowed difference between colors: [CIEDE2000](http://en.wikipedia.org/wiki/Color_difference#CIEDE2000). It is used only in a non-strict mode. By default: `2.3`. The human eye can already discern the difference in colors starting from the value `2.3`. The lower this value, the stricter the comparison of screenshots will be.
+
+It is not recommended to increase the value of `tolerance` at the global level. Try setting `tolerance` for specific test suites or states instead.
+
+For example, if you need to take a screenshot for a specific state with an individual `tolerance` setting:
+
+```javascript
+it("some-test", async function (browser) {
+    await browser.assertView("some-state", ".selector1", { tolerance: 10 });
+    await browser.assertView("another-state", ".selector1");
+});
+```
+
+### antialiasingTolerance {#antialiasing_tolerance}
+
+Sets the sensitivity of the antialiasing definition, which will be ignored when comparing screenshots.
+
+Read more about this option in the [looks-same](https://github.com/gemini-testing/looks-same#comparing-images-with-ignoring-antialiasing) package.
+
+### compareOpts {#compare_opts}
+
+Additional options for comparing images. See a list of available options in the [looks-same](https://github.com/gemini-testing/looks-same#comparing-images) package documentation. By default:
+
+```javascript
+compareOpts: {
+    shouldCluster: false,
+    clustersSize: 10,
+    stopOnFirstFail: false
+}
+```
+
+### buildDiffOpts {#build_diff_opts}
+
+Additional options for building a diff (an image with a difference between screenshots). See a list of available options in the [looks-same](https://github.com/gemini-testing/looks-same#building-diff-image) package documentation. By default:
+
+```javascript
+buildDiffOpts: {
+    ignoreAntialiasing: true,
+    ignoreCaret: true
+}
+```
+
+### assertViewOpts {#assert_view_opts}
+
+Options for the command to take and compare screenshots `assertView`, which will be used by default. Can be overwritten when calling the `assertView` command. By default:
+
+```javascript
+assertViewOpts: {
+    ignoreElements: [],
+    captureElementFromTop: true,
+    allowViewportOverflow: false
+}
+```
+
+The following options are available for `assertView`:
+
+<table>
+<thead>
+<tr><td>**Option**</td><td>**Type**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>ignoreElements</td><td>Array or String</td><td>Elements (set as selectors) to ignore when comparing screenshots. Ignore is implemented by painting the listed elements in black. In the case of a single element, the parameter can be set as a string.</td></tr>
+<tr><td>tolerance</td><td>Number</td><td>Sensitivity to color difference. The value overwrites [browsers.tolerance](#tolerance).</td></tr>
+<tr><td>antialiasingTolerance</td><td>Number</td><td>Sensitivity in antialiasing. The value overwrites [browsers.antialiasingTolerance](#antialiasing_tolerance).</td></tr>
+<tr><td>allowViewportOverflow</td><td>Boolean</td><td>By default, testplane throws an error if the element is outside the boundaries of the viewport. This parameter disables checking for borders, allowing you to take screenshots of elements that do not fit into the viewport. At the same time, only those parts of the element that fit into the viewport will be visible in the screenshot. However, if _compositeImage_ is equal to _true_, then the parts of the element that were below the viewport's _bottom_ border will also be visible in the screenshot. Similarly, if _captureElementFromTop_ is equal to _true_, then the screenshot will also include those parts of the element that were above the viewport's _top_ border.</td></tr>
+<tr><td>captureElementFromTop</td><td>Boolean</td><td>Take a screenshot of the element from the very top. If the element is located outside the viewport, then a scroll will be made to it.</td></tr>
+<tr><td>compositeImage</td><td>Boolean</td><td>Allows you to test elements that do not fit into the viewport in height.</td></tr>
+<tr><td>screenshotDelay</td><td>Number</td><td>The delay in milliseconds before taking a screenshot. It can be useful when there are elements on the page that use animation, or a scrollbar that does not disappear immediately and gets to the resulting screenshot.</td></tr>
+<tr><td>selectorToScroll</td><td>String</td><td>The selector to scroll. It can be useful when you need to take a screenshot of a modal window that does not fit on the screen. Otherwise, without specifying the selector, the scroll will be applied to the _window_ object, and the background will be scrolled, leaving the pop-up window in place.</td></tr>
+
+</tbody>
+</table>
+
+### compositeImage {#composite_image}
+
+Allows you to test elements that do not fit into the viewport in height. By default: `true`. If the tested block is higher in height than the viewport, then the images of several viewports are joined into one image.
+
+### screenshotMode {#screenshot_mode}
+
+Mode of screenshots taking. By default: `auto`.
+
+Possible values:
+
+<table>
+<thead>
+<tr><td>auto</td><td>determine the mode automatically</td></tr>
+</thead>
+<tbody>
+<tr><td>fullpage</td><td>take a screenshot of the entire page</td></tr>
+<tr><td>viewport</td><td>take a screenshot of the viewport only</td></tr>
+
+</tbody>
+</table>
+
+By default, the `viewport` mode is set for android browsers in order to workaround [bug in Chromium](https://bugs.chromium.org/p/chromedriver/issues/detail?id=2853).
+
+It is possible to get an image of the entire page in desktop browsers _out of the box_, and not just the visible viewport. At the same time, you do not need to manually join the images of individual viewports into one large screenshot. However, there is no such functionality on mobile devices.
+
+### screenshotDelay {#screenshot_delay}
+
+The delay in milliseconds before taking a screenshot. By default: `0` ms. It can be useful when there are elements on the page that use animation, or a scrollbar that does not disappear immediately and gets to the resulting screenshot.
+
+## Request and response parameters {#params_of_requests_and_responses}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[agent](#agent)</td><td>Object</td><td>null</td><td>Defines your own [agents][got-agent] for requests over _http, https, http2_.</td></tr>
+<tr><td>[headers](#headers)</td><td>Object</td><td>null</td><td>Defines [headers][got-headers] to be passed in each request to WebDriver.</td></tr>
+<tr><td>[transformRequest](#transform_request)</td><td>Function</td><td>null</td><td>Allows you to intercept and convert [options][got-options] of an http request before a request to WebDriver.</td></tr>
+<tr><td>[transformResponse](#transform_response)</td><td>Function</td><td>null</td><td>Allows you to intercept and convert the [http response][got-response] received from WebDriver.</td></tr>
+<tr><td>[strictSSL](#strict_ssl)</td><td>Boolean</td><td>null</td><td>Defines whether the SSL certificate should be valid. If _true_, it means that [default value][strict-ssl] from WebdriverIO will be used.</td></tr>
+
+</tbody>
+</table>
+
+### agent {#agent}
+
+Allows you to set your own [agents][got-agent] for requests over _http, https, http2_. By default: `null` (in this case, the default http agents of the [got][got] package will be used).
+
+### headers {#headers}
+
+Allows you to configure [headers][got-headers] to be passed in each request to WebDriver. By default: `null`. See also in WebdriverIO [documentation](https://webdriver.io/docs/options/#headers).
+
+<Admonition type="warning">
+    These headers are not passed to the request to the browser in which the tests are run. They are
+    sent only in requests to WebDriver.
+</Admonition>
+
+### transformRequest {#transform_request}
+
+Allows you to intercept and convert [options][got-options] of an http request before a request to WebDriver. By default: `null`. If a function is passed, the `RequestOptions` object will be passed to it as the first argument. In response, the function will have to return the modified `RequestOptions`.
+
+Type of function:
+
+```javascript
+RequestOptions => RequestOptions;
+```
+
+### transformResponse {#transform_response}
+
+Allows you to intercept and convert the [http response][got-response] received from WebDriver. By default: `null`. If a function is passed, the `Response` object will be passed to it as the first argument, and `RequestOptions` as the second. In response, the function will have to return a modified `Response`.
+
+Type of function:
+
+```javascript
+(Response, RequestOptions) => Response;
+```
+
+### strictSSL {#strict_ssl}
+
+Defines whether the SSL certificate should be valid. If `true`, it means that [default value][strict-ssl] from WebdriverIO will be used.
+
+## Cloud settings {#cloud_settings}
+
+The following settings may be useful if you want to run your testplane tests in cloud service browsers.
+
+[SauceLabs][sauce-labs] is an example of such a cloud service, which [can provide](https://saucelabs.com/platform/cross-browser-testing) you both desktop and mobile browsers to run tests in them.
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>user</td><td>String</td><td>null</td><td>The name of the user in the cloud service.</td></tr>
+<tr><td>key</td><td>String</td><td>null</td><td>Access key or secret key for accessing the cloud service.</td></tr>
+<tr><td>region</td><td>String</td><td>null</td><td>Allows you to select different data centers in the cloud service.</td></tr>
+<tr><td>headless</td><td>String</td><td>null</td><td>Allows you to run a headless browser in a cloud service.</td></tr>
+
+</tbody>
+</table>
+
+### user {#user}
+
+The name of the user in the cloud service. By default: `null`.
+
+### key {#key}
+
+Access key or secret key for accessing the cloud service. By default: `null`.
+
+### region {#region}
+
+Allows you to select different data centers in the cloud service. By default: `null`.
+
+### headless {#headless}
+
+Allows you to run a headless browser in a cloud service. By default: `null`.
+
+[desired-caps]: https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities
+[html-reporter]: ../html-reporter/html-reporter-setup
+[got]: https://github.com/sindresorhus/got/
+[got-agent]: https://github.com/sindresorhus/got/blob/main/documentation/2-options.md#agent
+[got-headers]: https://github.com/sindresorhus/got/blob/main/documentation/2-options.md#headers
+[got-options]: https://github.com/sindresorhus/got/blob/main/documentation/2-options.md
+[got-response]: https://github.com/sindresorhus/got/blob/main/documentation/3-streams.md#response-2
+[strict-ssl]: https://webdriver.io/docs/options/#strictssl
+[read-tests]: ./browsers
+[sauce-labs]: https://saucelabs.com
+[system-mocha-opts]: ./system#mocha_opts
+[element-wait-until]: ../commands/element/waitUntil
+[webdriver-vs-cdp]: ../reference/webdriver-vs-cdp
+[how-to-use-cdp]: ../guides/how-to-use-cdp
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/config/main.mdx b/i18n/en/docusaurus-plugin-content-docs/current/config/main.mdx
new file mode 100644
index 0000000..57c182a
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/config/main.mdx
@@ -0,0 +1,106 @@
+---
+sidebar_class_name: hidden
+---
+
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+# Testplane config
+
+## Setup {#setup}
+
+To configure Testplane, use the following configuration file format:
+
+<Tabs>
+<TabItem value="Minimum config" label="Minimum config">
+```javascript
+  module.exports = {
+      browsers: {
+          chrome: {
+              desiredCapabilities: {
+                  browserName: 'chrome',
+
+                  // ...
+              },
+
+              // other chrome browser settings...
+          },
+
+          // other browsers settings...
+      }
+
+};
+
+````
+</TabItem>
+
+
+<TabItem value="Maximum config" label="Maximum config">
+```javascript
+module.exports = {
+    // global browser settings...
+
+    browsers: {
+        // browser-specific settings...
+    },
+    sets: {
+        // test group settings...
+        // test groups can be used, for example,
+        // to separate the launch of desktop and mobile tests
+    },
+    system: {
+        // system settings...
+    },
+    plugins: {
+        // external Testplane plugins settings...
+    },
+    prepareBrowser: function(browser) {
+        // here you can add new commands to the browser object,
+        // where browser is a WebdriverIO session
+    },
+    prepareEnvironment: function () {
+        // here you can set environment variables or
+        // change / add Testplane's config
+    }
+};
+````
+
+</TabItem>
+
+</Tabs>
+
+### Description of configuration sections {#config_sections_description}
+
+The only required section in Testplane settings is the `browsers` section.
+
+In order not to repeat common [settings of each browser][browsers] over and over again, you can take them to the global level.
+
+<table>
+<thead>
+<tr><td>**Name**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[browsers][browsers]</td><td>Required section. It sets the settings of all browsers in which the tests will be run.</td></tr>
+<tr><td>[sets][sets]</td><td>A section that allows you to bind a set of tests to certain browsers and run them at once with one command. For example, you can launch desktop and mobiles tests separately by using this option.</td></tr>
+<tr><td>[system][system]</td><td>Testplane system settings section. Allows you to set the number of subprocesses to run the tests in, enable the debug mode for WebDriver, and much more.</td></tr>
+<tr><td>[plugins][plugins]</td><td>A section with which you can mount external plugins to Testplane.</td></tr>
+<tr><td>[prepareBrowser][prepare-browser]</td><td>A function in which you can prepare the browser before to run the tests in it. For example, in this function you can add new commands for the _browser_ object.</td></tr>
+<tr><td>[prepareEnvironment][prepare-environment]</td><td>A function in which you can set environment variables or, for example, add some config parameters.</td></tr>
+
+</tbody>
+</table>
+
+Follow the link or select the appropriate section in the left navigation menu of the documentation to read more about the relevant settings.
+
+## Usage {#usage}
+
+By default, Testplane searches for the file `.testplane.conf.js` at startup in the current working folder.
+
+You can set your configuration file using the `--config` CLI option, specifying the path to the file relative to the current working folder as the option value.
+
+[browsers]: ./browsers
+[sets]: ./sets
+[system]: ./system
+[plugins]: ./plugins
+[prepare-browser]: ./prepare-browser
+[prepare-environment]: ./prepare-environment
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/config/plugins.mdx b/i18n/en/docusaurus-plugin-content-docs/current/config/plugins.mdx
new file mode 100644
index 0000000..8b10db2
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/config/plugins.mdx
@@ -0,0 +1,82 @@
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+import Admonition from "@theme/Admonition";
+
+# plugins
+
+## Overview {#overview}
+
+Use the `plugins` section to mount external plugins to testplane, which will expand the available functionality.
+
+For example, plugins [html-reporter][html-reporter] or [testplane-test-repeater][testplane-test-repeater].
+
+A plugin is a module that exports a single function with the following arguments:
+
+-   testplane instance
+-   plugin options from testplane config
+
+All plugins will be loaded before testplane runs the tests.
+
+<Admonition type="tip">
+    When choosing a name for a plugin, add the prefix _testplane-_ to it. Then it will be easier to
+    search for such a plugin.
+</Admonition>
+
+If the plugin name starts with the prefix `testplane-`, then you can omit this prefix when adding the plugin to the `plugins` section. If testplane discovers modules with both names on the file system: _testplane-some-module_ and _some-module_, it will give preference to the module with the prefix `testplane-`.
+
+## Draft example {#example}
+
+<Tabs>
+<TabItem value=".testplane.conf.js" label=".testplane.conf.js">
+```javascript
+  module.exports = {
+      plugins: {
+          'my-cool-plugin': {
+              param: 'some-value'
+          },
+
+          // other testplane plugins...
+      },
+
+      // other testplane settings...
+
+};
+
+````
+</TabItem>
+
+
+<TabItem value="testplane-my-cool-plugin/index.js" label="testplane-my-cool-plugin/index.js">
+```javascript
+module.exports = function(testplane, opts) {
+    testplane.on(testplane.events.RUNNER_START, function(runner) {
+        console.info(opts.param); // outputs "some-value", see the plugin config in testplane
+
+        return setUp(testplane.config, opts.param); // config parameters can be changed
+    });
+
+    testplane.on(testplane.events.RUNNER_END, function() {
+        return tearDown();
+    });
+};
+````
+
+</TabItem>
+
+</Tabs>
+
+## Properties of testplane instance {#testplane_instance}
+
+<table>
+<thead>
+<tr><td>config</td><td>The config to use in the test runner. Can be changed.</td></tr>
+</thead>
+<tbody>
+<tr><td>events</td><td>A list of events to subscribe to.</td></tr>
+
+</tbody>
+</table>
+
+[html-reporter]: ../html-reporter/html-reporter-setup
+[testplane-test-repeater]: ../plugins/testplane-test-repeater
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/config/prepare-browser.mdx b/i18n/en/docusaurus-plugin-content-docs/current/config/prepare-browser.mdx
new file mode 100644
index 0000000..4400822
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/config/prepare-browser.mdx
@@ -0,0 +1,159 @@
+import Admonition from "@theme/Admonition";
+
+# prepareBrowser
+
+## Overview {#overview}
+
+This parameter is a hook. Testplane calls the function specified for this parameter before running tests in the browser. As an argument, the function receives a link to the browser session.
+
+Use this function to add new commands to the browser, or to expand the behaviour of existing commands.
+
+## Usage examples {#example}
+
+### Example 1: adding a new command for the browser {#example_add_new_command_to_browser}
+
+To add a new command, use [browser.addCommand()][add-command] of WebdriverIO.
+
+```javascript
+const querystring = require("querystring");
+
+function toStoryKind(value) {
+    /* here goes some code */
+}
+function toStoryId(value) {
+    /* here goes some code */
+}
+
+module.exports = {
+    prepareBrowser: function (browser) {
+        browser.addCommand("openScenario", function openScenario(rawComponent, rawStory, params) {
+            const component = toStoryKind(rawComponent);
+            const story = toStoryId(rawStory);
+            const queryParams = querystring.stringify(params);
+            const url = `/storybook/iframe.html?id=components-${component}-testplane--${story}&${queryParams}`;
+
+            return this.url(url);
+        });
+    },
+
+    // other Testplane settings...
+};
+```
+
+### Example 2: adding a new command for the element {#example_2_add_new_command_to_element}
+
+You can add a command not for the browser, but for the element. Then the third argument of the [browser.addCommand()][add-command] function must specify `true`.
+
+<Admonition type="warning">
+    If a command is added for an element and not for the browser, then the function is executed in
+    the context of the element!
+</Admonition>
+
+```javascript
+module.exports = {
+    prepareBrowser: function(browser) {
+        await browser.addCommand(
+            'getCoords',
+            async function () {
+                // inside the function, the context is element, not browser!
+                const { x, y } = await this.getLocation();
+                const { width, height } = await this.getSize();
+
+                return {
+                    left: x,
+                    top: y,
+                    right: x + width,
+                    bottom: y + height
+                };
+            },
+            true // true means that we set the function for the element, (by default) false – for the browser
+        );
+    },
+
+    // other Testplane settings...
+};
+```
+
+In the function above we use the commands [getLocation()][get-location] and [getSize()][get-size], which are available for the element in WebdriverIO.
+
+After adding the `getCoords()` command, we can use it in tests as follows:
+
+```javascript
+const { left, top, right, bottom } = await browser.$(‘.selector’).getCoords();
+```
+
+### Example 3: changing an existing command {#example_3_overwrite_command}
+
+To change an existing command, use [browser.overwriteCommand()][overwrite-command] of WebdriverIO.
+
+For example, we may want to pass an object with query parameters to the [browser.url()][url] command as a separate argument:
+
+```javascript
+const { URL } = require("url");
+
+module.exports = {
+    prepareBrowser: function (browser) {
+        browser.overwriteCommand("url", function (origUrlFunction, uri, query) {
+            if (!query) {
+                return origUrlFunction(uri);
+            }
+
+            const parsedUrl = new URL(uri);
+
+            for (const [key, value] of Object.entries(query)) {
+                parsedUrl.searchParams.set(key, value);
+            }
+
+            return origUrlFunction(parsedUrl.href);
+        });
+    },
+
+    // other Testplane settings...
+};
+```
+
+### Example 4: adding a set of commands from the folder {#example_4_add_commands_from_folder}
+
+If the project has a lot of its own specific commands, then it is convenient to store them in a separate folder, and add all commands in `prepareBrowser` at once in a unified way. For example:
+
+```javascript
+const path = require("path");
+const glob = require("fast-glob");
+
+module.exports = {
+    prepareBrowser: function (browser) {
+        const files = glob.sync(["tests/testplane/commands/*.(js|ts)", "!**/*.d.ts"]);
+
+        files.forEach(file => {
+            const module = require(path.resolve(process.cwd(), file));
+            const name = path.basename(file, path.extname(file));
+
+            browser.addCommand(name, typeof module === "object" ? module[name] : module);
+        });
+    },
+
+    // other Testplane settings...
+};
+```
+
+In this case, a file with one of the commands may look like this:
+
+```javascript
+// tests/testplane/commands/yaCheckCookie.js
+
+module.exports = async function (cookieName) {
+    // the context in the function is browser
+    const cookies = await this.getCookies(cookieName);
+
+    assert.isTrue(cookies[0], `cookie with name ${cookieName} is not set`);
+};
+```
+
+Here we use the [browser.getCookies()][get-cookies] command of WebDriverIO.
+
+[url]: ../commands/browser/url
+[add-command]: ../commands/browser/addCommand
+[overwrite-command]: ../commands/browser/overwriteCommand
+[get-cookies]: ../commands/browser/getCookies
+[get-location]: ../commands/element/getLocation
+[get-size]: ../commands/element/getSize
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/config/prepare-environment.mdx b/i18n/en/docusaurus-plugin-content-docs/current/config/prepare-environment.mdx
new file mode 100644
index 0000000..cf3ade2
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/config/prepare-environment.mdx
@@ -0,0 +1,21 @@
+# prepareEnvironment
+
+## Overview {#overview}
+
+This parameter is a hook. Testplane calls the function specified for this parameter after reading Testplane config. With it, you can set environment variables or, for example, add some config parameters.
+
+The context of the function is the Testplane config.
+
+## Usage example {#example}
+
+```javascript
+const { pick } = require("lodash");
+
+module.exports = {
+    prepareEnvironment: function () {
+        this.sets = pick(this.sets, ["touch-phone"]);
+    },
+
+    // other Testplane settings...
+};
+```
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/config/sets.mdx b/i18n/en/docusaurus-plugin-content-docs/current/config/sets.mdx
new file mode 100644
index 0000000..0618e06
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/config/sets.mdx
@@ -0,0 +1,110 @@
+# sets
+
+## Overview {#overview}
+
+You can use sets to bind a set of tests to specific browsers and run them at once with one command.
+
+For example, it can be convenient to run tests on platforms: `desktop`, `touch-phone`, etc. You can also have a `common` set corresponding to common tests that you will always run in all browsers.
+
+Define a set of tests as an array of paths to them or to folders with them on the file system. You can also specify paths to ignore when searching for tests to speed up the process of reading tests by testplane.
+
+If there are no sets in the config, or you do not specify them when starting testplane (see the section "[Usage](#usage)"), then all tests from the `testplane` folder will be run in all browsers that were specified in the [browsers][browsers] section of testplane config.
+
+## Setup {#setup}
+
+The `sets` section has the following format:
+
+```javascript
+module.exports = {
+    sets: {
+        "<set-id>": {
+            files: [
+                "path-1",
+                "some/folder/**/*.some-ext",
+                // other paths to the test files...
+            ],
+            ignoreFiles: [
+                "ignorePath-1",
+                "some/ignore/folder/**/",
+                // other paths to ignore when searching and reading tests...
+            ],
+            browsers: [
+                "browser-1",
+                "browser-2",
+                // other browsers in which you need to run tests on the paths specified in files...
+            ],
+        },
+
+        // other sets settings...
+    },
+
+    // other testplane settings...
+};
+```
+
+Where `<set-id>` is the name of the set to identify it.
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>files</td><td>Array or String</td><td>_N/A_</td><td>A list of paths to files or folders with tests. In the case of a single path, the parameter can be set as a string. You can also use [masks][fast-glob-patterns].</td></tr>
+<tr><td>ignoreFiles</td><td>Array or String</td><td>`[ ]`</td><td>A list of paths or [masks][fast-glob-patterns] to ignore when searching for test files. This parameter allows you to speed up the reading of tests by testplane.</td></tr>
+<tr><td>browsers</td><td>Array</td><td>_all browsers_</td><td>The list of browsers to run the tests in. You can only specify browsers that are in the [browsers][browsers] section of testplane config. By default: all browsers from the [browsers][browsers] section.</td></tr>
+
+</tbody>
+</table>
+
+## Setup example {#setup_example}
+
+```javascript
+module.exports = {
+    sets: {
+        common: {
+            // run tests from the "tests/common" folder in all browsers,
+            // which are configured in the browsers section
+            files: "tests/common/*.testplane.js",
+        },
+
+        desktop: {
+            files: ["tests/desktop/*.testplane.js", "tests/common/*.testplane.js"],
+            // exclude folders with screenshots while searching for test files
+            ignoreFiles: ["**/screens/**"],
+            // run tests in desktop browsers
+            browsers: ["chrome", "firefox"],
+        },
+    },
+
+    browsers: {
+        chrome: {
+            // chrome browser settings...
+        },
+        firefox: {
+            // firefox browser settings...
+        },
+        iphone: {
+            // iphone browser settings...
+        },
+    },
+
+    // other testplane settings...
+};
+```
+
+## Usage {#usage}
+
+Use the `--set` CLI option to specify a set when running tests.
+
+Example of how to run tests for a desktop platform in the case of the configuration given [above](#setup_example):
+
+```bash
+testplane --set desktop
+```
+
+If there are no sets in the config, or they exist, but the `--set` option was not specified, and the paths were not passed to testplane via the CLI, then all tests from the `testplane` folder will be run in all [browsers][browsers].
+
+[fast-glob-patterns]: https://github.com/mrmlnc/fast-glob#pattern-syntax
+[browsers]: ./browsers
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/config/system.mdx b/i18n/en/docusaurus-plugin-content-docs/current/config/system.mdx
new file mode 100644
index 0000000..ff76512
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/config/system.mdx
@@ -0,0 +1,163 @@
+import Admonition from "@theme/Admonition";
+
+# system
+
+## Overview {#overview}
+
+The `system` section in Testplane settings is optional.
+
+Use it to:
+
+-   enable debug mode for WebDriver;
+-   change mocha timeouts for tests;
+-   put any data in a global context that all tests will see;
+-   set the types of errors in which you need to close the current browser session forever, and not try to reuse it;
+-   set the number of subprocesses in which tests will be run to speed up their execution;
+-   determine the maximum available number of browsers at one time (it may be relevant if you get browsers from a cloud service where there are such restrictions);
+-   set file extensions, among which Testplane will look for tests;
+-   etc.
+
+## Setup {#setup}
+
+The `system` section has the following format:
+
+```javascript
+module.exports = {
+    system: {
+        debug: false,
+        mochaOpts: {
+            timeout: 60000,
+        },
+        ctx: {
+            // ...
+        },
+        // The session will be closed if the test crashes with an error,
+        // corresponding to one of the specified templates,
+        // after which a new session will be created,
+        // to eliminate infrastructure problems
+        patternsOnReject: [
+            /timeout/i,
+            /timedout/i,
+            /timed out/i,
+            // ...
+        ],
+        workers: 1,
+        testsPerWorker: Infinity,
+        parallelLimit: 15,
+        fileExtensions: [".js", ".ts"],
+    },
+
+    // other Testplane settings...
+};
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[debug](#debug)</td><td>Boolean</td><td>false</td><td>Enable / disable debugging mode for WebDriver.</td></tr>
+<tr><td>[mochaOpts](#mocha_opts)</td><td>Object</td><td>_[see below](#mocha_opts)_</td><td>Additional options for _mocha_.</td></tr>
+<tr><td>[ctx](#ctx)</td><td>Object</td><td>`{ }`</td><td>The context you can get in all tests via the _testplane.ctx_ method.</td></tr>
+<tr><td>[patternsOnReject](#patterns_on_reject)</td><td>Array</td><td>`[ ]`</td><td>List of error patterns. The session will be closed if the test crashes with an error corresponding to one of the specified templates. After that, a new session will be created to eliminate infrastructure problems.</td></tr>
+<tr><td>[workers](#workers)</td><td>Number</td><td>1</td><td>The number of subprocesses that will be started to run tests.</td></tr>
+<tr><td>[testsPerWorker](#tests_per_worker)</td><td>Number</td><td>Infinity</td><td>The maximum number of tests that will be run in a single subprocess before the subprocess is restarted.</td></tr>
+<tr><td>[parallelLimit](#parallel_limit)</td><td>Number</td><td>1</td><td>The maximum number of browsers that can be launched simultaneously.</td></tr>
+<tr><td>[fileExtensions](#file_extensions)</td><td>Array</td><td>`[.js]`</td><td>File extensions in which Testplane will look for tests to run.</td></tr>
+
+</tbody>
+</table>
+
+### debug {#debug}
+
+Enables debugging mode for WebDriver if set to `true`. By default: `false`.
+
+### mochaOpts {#mocha_opts}
+
+Additional options for `mocha` that are passed to `mocha.setup`. See the list of available options in [Mocha documentation](https://mochajs.org/). By default: `{ timeout: 60000 }`.
+
+```javascript
+module.exports = {
+    system: {
+        mochaOpts: {
+            timeout: 60000, // test execution timeout
+        },
+
+        // other system settings...
+    },
+
+    // other Testplane settings...
+};
+```
+
+### ctx {#setup_ctx}
+
+The context you can get in all tests via the `testplane.ctx` method. Designed to share any data between all tests, without having to use global variables.
+
+For example:
+
+```javascript
+module.exports = {
+    system: {
+        ctx: {
+            services: ["video", "images"],
+        },
+
+        // other system settings...
+    },
+
+    // other Testplane settings...
+};
+```
+
+```javascript
+it("awesome test", function () {
+    console.log(testplane.ctx); // { services: ['video', 'images'] }
+});
+```
+
+<Admonition type="tip">Use _testplane.ctx_ in tests instead of global variables.</Admonition>
+
+### patternsOnReject {#patterns_on_reject}
+
+Testplane will close the session if the test crashes with an error corresponding to one of the specified patterns in `patternsOnReject`. After that, Testplane will create a new session to eliminate infrastructure problems.
+
+For example:
+
+```javascript
+module.exports = {
+    system: {
+        patternsOnReject: [
+            /timeout/i,
+            /timedout/i,
+            /timed out/i,
+
+            // other patterns...
+        ],
+
+        // other system settings...
+    },
+
+    // other Testplane settings...
+};
+```
+
+### workers {#workers}
+
+Testplane runs all the tests in subprocesses to reduce CPU usage for the main process and not to run into the memory limit for _Node.js._ This option sets the number of subprocesses that will be started to run tests. By default: `1`.
+
+### testsPerWorker {#tests_per_worker}
+
+The maximum number of tests that will be run in a single subprocess before the subprocess is restarted. By default: `Infinity`.
+
+### parallelLimit {#parallel_limit}
+
+By default, Testplane runs all browsers at the same time. Sometimes (for example, when using cloud services such as [SauceLabs][sauce-labs]) you may need to limit the number of browsers that can be running at the same time. This option sets this restriction. By default: `Infinity`.
+
+### fileExtensions {#file_extensions}
+
+File extensions in which Testplane will search on the file system for tests to run. By default: `[.js]`.
+
+[sauce-labs]: https://saucelabs.com
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-api.mdx b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-api.mdx
new file mode 100644
index 0000000..63c3d3f
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-api.mdx
@@ -0,0 +1,216 @@
+# Html-Reporter API
+
+## Overview {#overview}
+
+Html-reporter adds an `htmlReporter` object to the `testplane` object with its own API.
+
+<table>
+<thead>
+<tr><td>**Name**</td><td>**Type**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[events](#events)</td><td>Object</td><td>A list of events to subscribe to.</td></tr>
+<tr><td>[extraItems](#extraitems)</td><td>Object</td><td>Additional elements to be added to the burger menu of the report.</td></tr>
+<tr><td>[imagesSaver](#imagessaver)</td><td>Object</td><td>Interface for saving images to the user's storage.</td></tr>
+<tr><td>[reportsSaver](#reportssaver)</td><td>Object</td><td>Interface for saving sqlite databases to the user's storage.</td></tr>
+<tr><td>[addExtraItem](#addextraitem)</td><td>Method</td><td>Adds an additional item to the burger menu of the report.</td></tr>
+<tr><td>[downloadDatabases](#downloaddatabases)</td><td>Method</td><td>Downloads all databases from the given files of the type _databaseUrls.json_.</td></tr>
+<tr><td>[mergeDatabases](#mergedatabases)</td><td>Method</td><td>Merges all given databases and saves the final report on the specified path.</td></tr>
+<tr><td>[getTestsTreeFromDatabase](#getteststreefromdatabase)</td><td>Method</td><td>Returns the test tree from the passed database.</td></tr>
+
+</tbody>
+</table>
+
+## events
+
+A list of events to subscribe to.
+
+For more information, see the section "[Events](./html-reporter-events)".
+
+## extraItems
+
+Additional elements to be added to the burger menu of the report.
+
+To add elements, use the [addExtraItem](#addextraitem) method.
+
+## imagesSaver
+
+Interface for saving images to the user's storage.
+
+### Usage example {#images_saver_usage_example}
+
+```javascript
+const MyStorage = require("my-storage");
+const myStorage = new MyStorage();
+
+module.exports = (testplane, opts) => {
+    testplane.on(testplane.events.INIT, async () => {
+        testplane.htmlReporter.imagesSaver = {
+            /**
+             * Save the image to a custom storage.
+             * The function can be either asynchronous or synchronous.
+             * The function should return the path or URL to the saved image.
+             * @property {String} localFilePath – the path to the image on the file system
+             * @param {Object} options
+             * @param {String} options.destPath – the path to the image in the html-report
+             * @param {String} options.reportDir - path to the html-report folder
+             * @returns {String} the path or URL to the image
+             */
+            saveImg: async (localFilePath, options) => {
+                const { destPath, reportDir } = options;
+                const imageUrl = await myStorage.save(localFilePath, destPath, reportDir);
+
+                // ...
+
+                return imageUrl;
+            },
+        };
+    });
+};
+```
+
+## reportsSaver
+
+Interface for saving sqlite databases to the user's storage.
+
+### Usage example {#reports_saver_usage_example}
+
+```javascript
+const MyStorage = require("my-storage");
+const myStorage = new MyStorage();
+
+module.exports = (testplane, opts) => {
+    testplane.on(testplane.events.INIT, async () => {
+        testplane.htmlReporter.reportsSaver = {
+            /**
+             * Save sqlite database to user storage.
+             * The function can be either asynchronous or synchronous.
+             * The function should return the path or URL to the saved sqlite database.
+             * @property {String} localFilePath – the path to the sqlite database on the file system
+             * @param {Object} options
+             * @param {String} options.destPath – the path to the sqlite database in the html-report
+             * @param {String} options.reportDir - path to the html-report folder
+             * @returns {String} the path or URL to the sqlite database
+             */
+            saveReportData: async (localFilePath, options) => {
+                const { destPath, reportDir } = options;
+                const dbUrl = await myStorage.save(localFilePath, destPath, reportDir);
+
+                // ...
+
+                return dbUrl;
+            },
+        };
+    });
+};
+```
+
+## addExtraItem
+
+Adds an additional item to the burger menu of the report.
+
+### Example of a call {#add_extra_item_call_example}
+
+```javascript
+testplane.htmlReporter.addExtraItem(caption, url);
+```
+
+### Call parameters {#add_extra_item_call_params}
+
+All parameters are required.
+
+<table>
+<thead>
+<tr><td>**Parameter&nbsp;name**</td><td>**Type**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>caption</td><td>String</td><td>The name of the item to add to the burger menu.</td></tr>
+<tr><td>url</td><td>String</td><td>The URL to which the menu item to be added will link.</td></tr>
+
+</tbody>
+</table>
+
+## downloadDatabases
+
+Downloads all databases from the given files of the type `databaseUrls.json`.
+
+### Example of a call {#download_databases_call_example}
+
+```javascript
+const dbPaths = await testplane.htmlReporter.downloadDatabases([".databaseUrls.json"], {
+    pluginConfig,
+});
+```
+
+### Call parameters {#download_databases_call_params}
+
+The function takes 2 arguments—a list of paths to the files `databaseUrls.json` in the form of an array of strings and an object with the key `pluginConfig`, in the value of which the plugin config is stored.
+
+The function returns a list of paths to saved databases.
+
+## mergeDatabases
+
+Merges all given databases and saves the final report on the specified path.
+
+### Example of a call {#merge_databases_call_example}
+
+```javascript
+await testplane.htmlReporter.mergeDatabases(srcDbPaths, path);
+```
+
+### Call parameters {#merge_databases_call_params}
+
+<table>
+<thead>
+<tr><td>**Parameter&nbsp;name**</td><td>**Type**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>srcDbPaths</td><td>String[]</td><td>Paths to databases.</td></tr>
+<tr><td>path</td><td>String</td><td>The path where the resulting database will be saved.</td></tr>
+
+</tbody>
+</table>
+
+## getTestsTreeFromDatabase
+
+Returns the test tree from the passed database.
+
+### Example of a call {#get_tests_tree_from_database_call_example}
+
+```javascript
+const dbTree = testplane.htmlReporter.getTestsTreeFromDatabase(mergedDbPath);
+```
+
+### Call parameters {#get_tests_tree_from_database_call_params}
+
+The function takes one argument—the path to the database with the result of the tests run.
+
+### Usage example {#get_tests_tree_from_database_usage_example}
+
+```javascript
+function getSuccessTestRunIds({ testplane, mergedDbPath }) {
+    const dbTree = testplane.htmlReporter.getTestsTreeFromDatabase(mergedDbPath);
+
+    const successTestRunIds = [];
+
+    for (const browserId of dbTree.browsers.allIds) {
+        const browser = dbTree.browsers.byId[browserId];
+        const lastResultId = _.last(browser.resultIds);
+        const lastResult = lastResultId && dbTree.results.byId[lastResultId];
+
+        if (!lastResult || lastResult.status !== SUCCESS) {
+            continue;
+        }
+
+        const testRunId = new URL(lastResult.suiteUrl).searchParams.get("testRunId");
+
+        if (!testRunId) {
+            continue;
+        }
+
+        successTestRunIds.push(testRunId);
+    }
+
+    return successTestRunIds;
+}
+```
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-commands.mdx b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-commands.mdx
new file mode 100644
index 0000000..03c1302
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-commands.mdx
@@ -0,0 +1,110 @@
+# Html-Reporter Commands
+
+## Overview {#overview}
+
+The `html-reporter` plugin adds the following commands to Testplane:
+
+-   [gui](#gui)—to run Testplane in GUI mode;
+-   [remove-unused-screens](#remove-unused-screens)—to remove reference screenshots that are not used in tests;
+-   [merge-reports](#merge-reports)—to merge Testplane's separate reports into one general report.
+
+## gui
+
+Use the `gui` command to launch Testplane in GUI mode.
+
+GUI mode allows you to:
+
+-   run tests interactively;
+-   update screenshots—visually viewing them and taking only the necessary diffs;
+-   reuse reports from CI;
+-   filter the results of the run by errors, keys from meta, etc.
+
+### Usage {#gui_usage}
+
+```bash
+npx testplane gui
+```
+
+## remove-unused-screens
+
+Use the `remove-unused-screens` command to remove the reference screenshots that are not used in tests.
+
+### How does it work?
+
+First, the command looks for screenshots for which there are no tests on the file system.
+
+Next, the command searches for screenshots that were not used in successful testing (the test result is taken from the SQLite database). To do this, the html-report must exist on the file system and contain the results of the tests run. This means that you must run the tests locally or download the report from CI before running the `remove-unused-screens` command.
+
+### Usage {#remove_unused_screens_usage}
+
+The `remove-unused-screens` command supports several options:
+
+<table>
+<thead>
+<tr><td>**Option**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>-p, --pattern &lt;pattern></td><td>A pattern for finding screenshots on the file system.</td></tr>
+<tr><td>--skip-questions</td><td>Do not ask questions during execution (use default values).</td></tr>
+<tr><td>-h, --help</td><td>Output the reference information on the command to the terminal.</td></tr>
+
+</tbody>
+</table>
+
+#### Usage examples {#usage_examples}
+
+Specifying the folder in which to search for unused screenshots:
+
+```bash
+npx testplane remove-unused-screens -p 'testplane-screens-folder'
+```
+
+Setting the pattern by which to search for screenshots:
+
+```bash
+npx testplane remove-unused-screens -p 'screens/**/*.png'
+```
+
+Setting several patterns by which to search for screenshots:
+
+```bash
+npx testplane remove-unused-screens -p 'screens/**/chrome/*.png' -p 'screens/**/firefox/*.png'
+```
+
+Specifying the folder in which to search for unused screenshots and setting _do-not-ask-questions_ option:
+
+```bash
+npx testplane remove-unused-screens -p 'testplane-screens-folder' --skip-questions
+```
+
+Getting the reference information about the command:
+
+```bash
+npx testplane remove-unused-screens --help
+```
+
+## merge-reports
+
+Use the `merge-reports` command to merge Testplane's separate reports into one general report.
+
+The command accepts paths to database files or to `databaseUrls.json` files from other html-reports. It creates a new html-report in the destination folder with a single file `databaseUrls.json`, which will contain a link to the database file or to the files `databaseUrls.json` from the input parameters. Database files are not copied to the destination folder at the same time.
+
+### Usage {#merge_reports_usage}
+
+The `merge-reports` command supports the following required option:
+
+<table>
+<thead>
+<tr><td>**Option**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>-d, --destination &lt;folder></td><td>The path to the folder where you want to save the final report.</td></tr>
+
+</tbody>
+</table>
+
+Usage example:
+
+```bash
+npx testplane merge-reports path-to-database.db path-to-databaseUrls.json -d dest-report
+```
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-custom-gui.mdx b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-custom-gui.mdx
new file mode 100644
index 0000000..fb16984
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-custom-gui.mdx
@@ -0,0 +1,110 @@
+import Admonition from "@theme/Admonition";
+
+# Html-Reporter Customizing GUI
+
+## Overview {#overview}
+
+<Admonition type="warning">
+    This method of GUI customization is outdated. It is recommended to use [report
+    plugins](./html-reporter-plugins) instead.
+</Admonition>
+
+Use the `customGui` option in the `html-reporter` plugin config to add custom controls for GUI mode.
+
+For controls, their type (button or radio button), labels and values, as well as initialization functions and the main click action are set. The controls should be divided into separate sections depending on their purpose. At least one section must be specified.
+
+By default, the value of the `customGui` option is `{}`.
+
+## Setup {#setup}
+
+The `customGui` option requires an object of the following format for its value:
+
+```javascript
+customGui: {
+    '<section name>': [
+        {
+            type: '<type of control>', // 'button' or 'radiobutton'
+            controls: [
+                {
+                    label: '<label on the control>',
+                    value: '<value of the control>'
+                },
+
+                // other controls...
+            ],
+            initialize: async ({ testplane, ctx }) => {
+                // initialization code
+                // the return value will be ignored
+            },
+            action: async ({ testplane, ctx, control }) => {
+                // action code
+                // the return value will be ignored
+            }
+        },
+
+        // other groups of controls...
+    ],
+
+    // other sections...
+}
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>type</td><td>String</td><td>Required parameter. The type of controls. Available values: _'button'_ and _'radiobutton'_.</td></tr>
+<tr><td>controls</td><td>Array</td><td>An array of objects, each of which describes a control. The object must consist of two keys: _label_ and _value_, which specify the label on the control and its value.</td></tr>
+<tr><td>initialize</td><td>Function</td><td>Optional parameter. Asynchronous function that will be executed on the server side when Testplane starts in GUI mode. An object of the form _\{ testplane, ctx }_ will be passed to the function, where _testplane_ is an instance of testplane, and _ctx_ is an object describing a group of elements for which the initialization function is called.</td></tr>
+<tr><td>action</td><td>Function</td><td>Required parameter. Asynchronous function that will be executed on the server side when the user clicks on the control. An object of the form _\{ testplane, ctx, control }_ will be passed to the function, where _testplane_ is an instance of testplane, _ctx_ is an object describing a group of elements for which the _action_ function is called, and _control_ is a link to the control that the user clicked on.</td></tr>
+
+</tbody>
+</table>
+
+## Usage example {#usage_example}
+
+Adding radio buttons to change the base URL in GUI mode:
+
+```javascript
+customGui: {
+    'some-meaningful-name-of-section': [
+        {
+            type: 'radiobutton',
+            controls: [
+                {
+                    label: 'Dev',
+                    value: 'http://localhost/development/'
+                },
+                {
+                    label: 'Prod',
+                    value: 'http://localhost/production/'
+                }
+            ],
+            initialize: async ({ testplane, ctx }) => {
+                const { config } = testplane;
+                const browserIds = config.getBrowserIds();
+
+                if (browserIds.length) {
+                    const { baseUrl } = config.forBrowser(browserIds[0]);
+
+                    ctx.controls.forEach((control) => {
+                        control.active = (baseUrl === control.value);
+                    });
+                }
+            },
+            action: async ({ testplane, ctx, control }) => {
+                const { config } = testplane;
+
+                config
+                    .getBrowserIds()
+                    .forEach((browserId) => {
+                        config.forBrowser(browserId).baseUrl = control.value;
+                    });
+            }
+        }
+    ]
+}
+```
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-events.mdx b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-events.mdx
new file mode 100644
index 0000000..7b8c4d1
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-events.mdx
@@ -0,0 +1,124 @@
+# Html-Reporter Events
+
+## Overview {#overview}
+
+The `html-reporter` plugin adds a special _htmlReporter_ object to Testplane's interface, through which, among other things, you can subscribe to report events. To do this, `testplane.htmlReporter` provides the `events` property with a list of events to subscribe to:
+
+-   [DATABASE_CREATED](#database_created)—an event that is triggered immediately after the sqlite database is created;
+-   [TEST_SCREENSHOTS_SAVED](#test_screenshots_saved)—the event that is triggered after saving screenshots of the test;
+-   [REPORT_SAVED](#report_saved)—the event that is triggered after saving all the report files.
+
+## DATABASE_CREATED
+
+**sync | master**
+
+The `DATABASE_CREATED` event is triggered immediately after the sqlite database is created. The event handler is executed synchronously.
+
+### Event subscription {#database_created_subscription}
+
+```javascript
+testplane.htmlReporter.on(testplane.htmlReporter.events.DATABASE_CREATED, db => {
+    console.info(`DATABASE_CREATED event processing is in progress...`);
+});
+```
+
+#### Handler parameters {#database_created_handler_params}
+
+A database instance is passed to the event handler.
+
+### Usage example {#database_created_example}
+
+```javascript
+const parseConfig = require("./config");
+
+module.exports = (testplane, opts) => {
+    const pluginConfig = parseConfig(opts);
+
+    if (!pluginConfig.enabled || testplane.isWorker()) {
+        // either the plugin is disabled, or we are in the context of a worker – we leave
+        return;
+    }
+
+    // the "htmlReporter" property is guaranteed to be in the "testplane" object
+    // at the time the INIT event is triggered
+    testplane.on(testplane.events.INIT, () => {
+        testplane.htmlReporter.on(testplane.htmlReporter.events.DATABASE_CREATED, db => {
+            db.prepare(`CREATE TABLE IF NOT EXISTS testTable (foo TEXT, bar TEXT)`).run();
+        });
+    });
+};
+```
+
+## TEST_SCREENSHOTS_SAVED
+
+**async | master**
+
+The `TEST_SCREENSHOTS_SAVED` event is triggered after saving screenshots of the next test. The event handler can be asynchronous.
+
+### Event subscription {#test_screenshots_saved_subscription}
+
+```javascript
+testplane.htmlReporter.on(
+    testplane.htmlReporter.events.TEST_SCREENSHOTS_SAVED,
+    async ({ testId, attempt, imagesInfo }) => {
+        console.info(
+            `Screenshots for test "${testId}" (attempt #${attempt}) were saved:`,
+            imagesInfo,
+        );
+
+        /* Expected output:
+        Screenshots for test "Feature Test.chrome-desktop" (attempt #0) were saved:
+        [
+            {
+                stateName: 'plain',
+                refImg: { path: '...', size: { width: 400, height: 200 } },
+                status: 'fail',
+                error: undefined,
+                diffClusters: [...],
+                expectedImg: { path: '...', size: { width: 400, height: 200 } }
+                actualImg: { path: '...', size: { width: 400, height: 200 } }
+                diffImg: { path: '...', size: { width: 400, height: 200 } }
+            }
+        ]
+        */
+    },
+);
+```
+
+#### Handler parameters {#test_screenshots_saved_handler_params}
+
+An object with information about the test of the following type is passed to the event handler:
+
+```javascript
+{
+    testId, // id of the test: "<test full title>.<browser id>"
+        attempt, // test execution attempt number
+        imagesInfo; // information about screenshots (see above example of event subscription)
+}
+```
+
+## REPORT_SAVED
+
+**async | master**
+
+The `REPORT_SAVED` event is triggered after saving all the report files. The event handler can be asynchronous.
+
+### Event subscription {#report_saved_subscription}
+
+```javascript
+testplane.htmlReporter.on(testplane.htmlReporter.events.REPORT_SAVED, async ({ reportPath }) => {
+    console.info(`REPORT_SAVED event processing is in progress, report path = ${reportPath}...`);
+});
+```
+
+#### Handler parameters {#report_saved_handler_params}
+
+An object with the key `reportPath` is passed to the handler, the value of which stores the path to the saved report.
+
+### Usage example {#report_saved_example}
+
+```javascript
+testplane.htmlReporter.on(testplane.htmlReporter.events.REPORT_SAVED, async ({ reportPath }) => {
+    await uploadDirToS3(reportPath); // uploading the report to S3 storage
+});
+```
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-plugins.mdx b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-plugins.mdx
new file mode 100644
index 0000000..3983391
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-plugins.mdx
@@ -0,0 +1,301 @@
+# Html-Reporter Plugins
+
+## Overview {#overview}
+
+Use the `plugins` option in the `html-reporter` plugin config to extend the functionality of the report using your own plugins to the report.
+
+To make your plugins work in the report, enable the [pluginsEnabled][plugins-enabled] option in the `html-reporter` plugin config by setting its value to `true`.
+
+The list of plugins is set as an array with their descriptions. By default, the list is considered empty: `[]`.
+
+Plugins allow you to add your own UI components to the report (both for a static report and for GUI mode), as well as server "handles" _(routes)_ (for GUI mode).
+
+## Setup {#setup}
+
+The description of plugins looks like this:
+
+```javascript
+plugins: [
+    {
+        name: "plugin-name",
+        component: "PluginReactComponentName",
+        point: "extension-point-name",
+        position: "wrap",
+        config: { param: "value" },
+    },
+    {
+        name: "plugin-name",
+        component: "AnotherPluginReactComponentName",
+        point: "extension-point-name",
+        position: "before",
+    },
+
+    // ...
+];
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[name](#name)</td><td>String</td><td>Required parameter. The name of the package with the plugin for the report. It is assumed that the plugin can be connected using _require(name)_.</td></tr>
+<tr><td>[component](#component)</td><td>String</td><td>The name of the React component from the plugin.</td></tr>
+<tr><td>[point](#point)</td><td>String</td><td>The name of the extension point in the _html-reporter_ plugin.</td></tr>
+<tr><td>[position](#position)</td><td>String</td><td>Defines the method by which the component will be placed at the extension point.</td></tr>
+<tr><td>[config](#config)</td><td>Object</td><td>Plugin configuration.</td></tr>
+
+</tbody>
+</table>
+
+A plugin for which only the `name` parameter is set can be used to override an existing GUI server middleware.
+
+A plugin can define more than one component. Each component can be applied to multiple extension points and/or multiple times to the same point (with separate configuration entries). The order in which components are applied is determined by the configuration order.
+
+### name
+
+Required parameter. The name of the package with the plugin for the report. It is assumed that the plugin can be connected using _require(name)_.
+
+### component
+
+The name of the React component from the plugin.
+
+### point
+
+The name of the extension point in the _html-reporter_ plugin.
+
+Defines the specific location of the specified component inside the html-reporter user interface.
+
+For more information, see the section "[Extension points](#extension_points)".
+
+### position
+
+Defines the method by which the component will be placed at the extension point of the html-report user interface.
+
+The following values are available:
+
+<table>
+<thead>
+<tr><td>**Value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>wrap</td><td>wrap the extension point in the UI</td></tr>
+<tr><td>before</td><td>place the component before the extension point</td></tr>
+<tr><td>after</td><td>place the component after the extension point</td></tr>
+
+</tbody>
+</table>
+
+### config
+
+Plugin configuration.
+
+## Plugin code for the report {#plugins_code}
+
+Examples of plugins can be [viewed in functional tests][html-reporter-plugins].
+
+The `html-reporter` plugin is an object with some set of React components specified as its keys, and an optional `reducers` key with an array of redux-reducers to control the state of components, which are later combined using [reduce-reducers][reduce-reducers].
+
+The plugin for the report is expected to have the following module files in the root of its package: `plugin.js` and/or `middleware.js`.
+
+### plugin.js
+
+Optional module. A file that should export an object (or a set of named exports) or a function that returns such an object or array with some specific structure.
+
+You can reuse the `html-reporter` dependencies in plugins (React, Redux, etc.). To do this, an array with a list of necessary dependencies must be exported from the module, followed by a function with the corresponding dependencies passed to it, and returning the plugin itself.
+
+For example:
+
+```javascript
+import "plugin-styles.css";
+
+export default [
+    "react",
+    function (React, options) {
+        class PluginComponent extends React.Component {
+            // component implementation
+        }
+
+        return {
+            PluginComponent,
+            reducers: [],
+        };
+    },
+];
+```
+
+Styles for the plugin must be loaded together with `plugin.js`, and the resulting file should be one bundle.
+
+Value exported from `plugin.js`, should be passed to `__testplane_html_reporter_register_plugin__`.
+
+There are two ways to do this.
+
+For example, configure the build by _webpack_ so that it creates the corresponding `jsonp` library:
+
+```javascript
+// ...
+output: {
+    filename: 'plugin.js',
+    path: __dirname,
+    library: '__testplane_html_reporter_register_plugin__',
+    libraryTarget: 'jsonp'
+},
+// ...
+```
+
+Or pass the value exported from `plugin.js`, clearly:
+
+```javascript
+__testplane_html_reporter_register_plugin__([
+    "react",
+    function (React, options) {
+        // ...
+        return { PluginComponent };
+    },
+]);
+```
+
+### middleware.js
+
+Optional module. Exports a function that accepts `Router` from [express][express]. It is expected that the "routes" of the plugin will be connected to the router. And the router then connects to the "route" `/plugin-routes/:PluginName/`.
+
+```javascript
+module.exports = function (pluginRouter) {
+    pluginRouter.get("/plugin-route", function (req, res) {
+        // "route" implementation
+    });
+};
+```
+
+Then the "routes" can be called from the React components of the plugin defined in `plugin.js`. For convenience, the plugin name is always passed with options called `pluginName` when a function or an array of functions is used for export:
+
+```javascript
+export default ['react', 'axios', function(React, axios, { pluginName, pluginConfig, actions, actionNames, selectors }) {
+    class PluginComponent extends React.Component {
+        // ... somewhere inside the component ...
+        const result = await axios.get(`/plugin-routes/${pluginName}/plugin-route`);
+    }
+
+    return {
+        PluginComponent,
+        reducers: []
+    };
+}
+```
+
+In this example, you can also see the following properties:
+
+<table>
+<thead>
+<tr><td>**Property**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>pluginName</td><td>plugin name</td></tr>
+<tr><td>pluginConfig</td><td>plugin configuration</td></tr>
+<tr><td>actions</td><td>Redux-actions</td></tr>
+<tr><td>actionNames</td><td>action names in _html-reporter_ that are used in Redux-actions, allow to subscribe to report events</td></tr>
+<tr><td>selectors</td><td>cached report selectors that were created using the [reselect][redux-reselect] library</td></tr>
+
+</tbody>
+</table>
+
+### Available dependencies {#available_deps}
+
+The following dependencies are available in plugins:
+
+-   [react][react]
+-   [redux][redux]
+-   [react-redux][react-redux]
+-   [lodash][lodash]
+-   [prop-types][prop-types]
+-   [classnames][classnames]
+-   [semantic-ui-react][semantic-ui-react]
+-   [react-markdown][react-markdown]
+-   [reduce-reducers][reduce-reducers]
+-   [immer][immer]
+-   [reselect][redux-reselect]
+-   [axios][axios]
+
+### Available components {#available_components}
+
+#### `<Details />`
+
+A component with which you can switch the display of content.
+
+Usage example:
+
+```javascript
+// ...inside your React component
+
+render() {
+    return <Details
+        title='Some title'
+        content='Some content' // content that will appear by clicking on the title
+        extendClassNames='some_class_name' // you can add your own css classes to the component
+        onClick={() => console.log('clicked')} // as well as your handler
+    />
+}
+```
+
+where:
+
+<table>
+<thead>
+<tr><td>**Property**</td><td>**Type**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>title</td><td>String or JSX.Element</td><td>Required parameter. A header describing the information hidden under it.</td></tr>
+<tr><td>content</td><td>Function or String or String[] or JSX.Element</td><td>Required parameter. The content that will appear when you click on the title.</td></tr>
+<tr><td>extendClassNames</td><td>String or String[]</td><td>CSS classes to add to the component. Optional parameter.</td></tr>
+<tr><td>onClick</td><td>Function</td><td>The handler that will be called by clicking on the header. Optional parameter.</td></tr>
+
+</tbody>
+</table>
+
+## Extension points {#extension_points}
+
+Extension points are places in the user interface of the report that are available for extension using React components exported by _plugins for the report_.
+
+Each extension point can pass certain props to plugin components depending on the point itself. Since some plugins may rely on a specific placement and, therefore, on specific props, it is possible to restrict plugin components to certain extension points by specifying a static `point` property for such plugin components:
+
+```javascript
+class PluginComponent extends React.Component {
+    static point = "result";
+    // ...
+}
+```
+
+The following extension points are currently available:
+
+<table>
+<thead>
+<tr><td>**Point**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>result</td><td>Allows you to extend each test result. Adds the _resultId_ and _testName_ props to the plugin component.</td></tr>
+<tr><td>result_meta</td><td>Allows you to extend the meta information for each test result. Adds the _resultId_ and _testName_ props to the plugin component.</td></tr>
+<tr><td>menu-bar</td><td>Allows you to extend the menu.</td></tr>
+<tr><td>root</td><td>Allows you to add floating elements such as a modal window or a popup.</td></tr>
+
+</tbody>
+</table>
+
+An extension point can be extended by more than one component. In this case, the order in which components are applied is determined by the order in which plugins are configured. Each subsequent component is applied to all previously composed components at the extension point.
+
+[plugins-enabled]: ./html-reporter-setup#pluginsenabled
+[html-reporter-plugins]: https://github.com/gemini-testing/html-reporter/blob//master/./test/func/html-reporter-plugins
+[reduce-reducers]: https://github.com/redux-utilities/reduce-reducers
+[express]: https://github.com/expressjs/express
+[redux-reselect]: https://github.com/reduxjs/reselect
+[react]: https://github.com/facebook/react
+[redux]: https://github.com/reduxjs/redux
+[react-redux]: https://github.com/reduxjs/react-redux
+[lodash]: https://github.com/lodash/lodash
+[prop-types]: https://github.com/facebook/prop-types
+[classnames]: https://github.com/JedWatson/classnames
+[semantic-ui-react]: https://github.com/Semantic-Org/Semantic-UI-React
+[react-markdown]: https://github.com/remarkjs/react-markdown
+[immer]: https://github.com/immerjs/immer
+[axios]: https://github.com/axios/axios
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-setup.mdx b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-setup.mdx
new file mode 100644
index 0000000..2e4cc48
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/html-reporter/html-reporter-setup.mdx
@@ -0,0 +1,424 @@
+---
+sidebar_class_name: hidden
+---
+
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+import Admonition from "@theme/Admonition";
+
+# Html-Reporter Setup
+
+## Overview {#overview}
+
+Use the [html-reporter][html-reporter] plugin to get an html-report on the tests run.
+
+[//]: # "![Html-report](_images/html-reporter.overview.png)"
+
+<Admonition type="warning" title="Requirements for testplane">
+    For the html-reporter plugin to work correctly, [hermione][testplane] version 4 and higher is
+    required.
+</Admonition>
+
+The plugin saves the tests run results to the [SQLite][sqlite] database. Therefore, you will not be able to open the local report as a file using the `file://` protocol.
+
+To view the report, run Testplane in GUI mode:
+
+```bash
+npx testplane gui
+```
+
+Or run [http-server][http-server] in the report folder:
+
+```bash
+npx http-server -p 8000
+```
+
+If you are starting a local server not from the folder with the report, then specify the path to the report:
+
+```bash
+npx http-server ./testplane-report -p 8000
+```
+
+Then open the page `http://localhost:8000` in the browser.
+
+## Install {#install}
+
+```bash
+npm install -D html-reporter
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the Testplane config:
+
+<Tabs>
+<TabItem value="Minimum config" label="Minimum config">
+```javascript
+    module.exports = {
+        plugins: {
+            'html-reporter/testplane': {
+                enabled: true
+            },
+
+            // other Testplane plugins...
+        },
+
+        // other Testplane settings...
+    };
+    ```
+
+</TabItem>
+
+<TabItem value="Maximum config" label="Maximum config">
+```javascript
+    module.exports = {
+        plugins: {
+            'html-reporter/testplane': {
+                enabled: true,
+                path: 'my/testplane-reports',
+                defaultView: 'all',
+                baseHost: 'test.com',
+                errorPatterns: [
+                    'Parameter .* must be a string',
+                    {
+                        name: 'Cannot read property of undefined',
+                        pattern: 'Cannot read property .* of undefined',
+                        hint: '<div>google it, i dont know how to fix it =(</div>'
+                    }
+                ],
+                customScripts: [
+                    function() {
+                        // custom script
+                    },
+
+                    // other scripts...
+                ],
+                customGui: {
+                    // DEPRECATED
+                    // additional controls for GUI mode
+                    // use report plugins instead of customGui
+                },
+                pluginsEnabled: true,
+                plugins: [
+                    // report plugins...
+                ],
+                yandexMetrika: {
+                    counter: 1234567
+                }
+            },
+
+            // other Testplane plugins...
+        },
+
+        // other Testplane settings...
+    };
+    ```
+
+</TabItem>
+
+</Tabs>
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[enabled](#enabled)</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>[path](#path)</td><td>String</td><td>"testplane-report"</td><td>The path to the folder for saving html-report files.</td></tr>
+<tr><td>[saveErrorDetails](#saveerrordetails)</td><td>Boolean</td><td>false</td><td>Save / do not save error details in json files.</td></tr>
+<tr><td>[defaultView](#defaultview)</td><td>String</td><td>"all"</td><td>The test filtering mode when displayed, which will be set by default.</td></tr>
+<tr><td>[diffMode](#diffmode)</td><td>String</td><td>"3-up"</td><td>The mode of viewing diffs, which will be set by default.</td></tr>
+<tr><td>[baseHost](#basehost)</td><td>String</td><td>_N/A_</td><td>Replaces the original host address for viewing in the browser.</td></tr>
+<tr><td>[errorPatterns](#errorpatterns)</td><td>Object[] or String[]</td><td>[ ]</td><td>Error patterns with hints to improve the UX of the report.</td></tr>
+<tr><td>[metaInfoBaseUrls](#metainfobaseurls)</td><td>Object</td><td>`{ }`</td><td>Base URLs for generating links in the _Meta_ section based on meta information about the tests run.</td></tr>
+<tr><td>[saveFormat](#saveformat)</td><td>String</td><td>"sqlite"</td><td>DEPRECATED. Allows you to set the format in which the results of the tests run will be saved.</td></tr>
+<tr><td>[customGui](#customgui)</td><td>Object</td><td>`{ }`</td><td>DEPRECATED. Use [plugins](#plugins) instead. Description of custom controls for GUI mode.</td></tr>
+<tr><td>[pluginsEnabled](#pluginsenabled)</td><td>Boolean</td><td>false</td><td>Enable plugins for the report.</td></tr>
+<tr><td>[plugins](#plugins)</td><td>Object[]</td><td>[ ]</td><td>A list of plugins with their settings.</td></tr>
+<tr><td>[customScripts](#customscripts)</td><td>Function[]</td><td>[ ]</td><td>A list of functions that implement custom scripts. For example, Yandex.Metrika scripts or a Bug.</td></tr>
+<tr><td>[yandexMetrika](#yandexmetrika)</td><td>Object</td><td>`{ }`</td><td>[Yandex.Metrika][yandex-metrika].</td></tr>
+
+</tbody>
+</table>
+
+### enabled
+
+Enables or disables the plugin.
+
+### path
+
+The path to the folder for saving html-report files. By default, the files will be saved to the `testplane-report` folder in the current working folder.
+
+### saveErrorDetails
+
+Save or not save error details in json files (to the `error-details` folder).
+
+By default, "do not save": `false`.
+
+Any testplane plugin can add any details to the error object when it occurs. These details can help the user in debugging problems that have occurred in the test. Html-reporter saves these details in the `error-details` folder in a file named: `<hash from the full name of the test>-<browser>_<retry number>_<timestamp>.json`.
+
+Under the stack trace, the html-reporter adds an `Error details` section with a `<title>` link pointing to the json file. The user can open this file either in the browser or in any IDE.
+
+Example of how to add details to an error object from a plugin:
+
+```javascript
+const err = new Error("some error");
+
+err.details = {
+    title: "description, will be used as url title",
+    data: {}, // or [], or String
+};
+
+throw err;
+```
+
+### defaultView
+
+The test filtering mode when displayed, which will be set by default. The following values are available:
+
+<table>
+<thead>
+<tr><td>**View&nbsp;mode**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>all</td><td>all tests</td></tr>
+<tr><td>passed</td><td>only passed tests</td></tr>
+<tr><td>failed</td><td>only failed tests</td></tr>
+<tr><td>retried</td><td>only those tests in which there were retries (re-runs)</td></tr>
+<tr><td>skipped</td><td>only disabled (skipped) tests</td></tr>
+
+</tbody>
+</table>
+
+By default: `all`, that is, if the parameter is not set, all tests will be displayed.
+
+### diffMode
+
+The mode of viewing diffs, which will be set by default. The following values are available:
+
+<table>
+<thead>
+<tr><td>**Diff&nbsp;mode**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>3-up</td><td>all images _(expected, actual, diff)_ in one column, under each other</td></tr>
+<tr><td>3&#8209;up&#8209;scaled</td><td>all images _(expected, actual, diff)_ in one row so that they fit on the screen</td></tr>
+<tr><td>only-diff</td><td>only diff image</td></tr>
+<tr><td>switch</td><td>reference image with the ability to switch to the actual image by mouse click</td></tr>
+<tr><td>swipe</td><td>the actual image on top of the reference image, with a separator opening the reference image</td></tr>
+<tr><td>onion-skin</td><td>the actual image on top of the reference with the ability to change the transparency of the actual image</td></tr>
+
+</tbody>
+</table>
+
+By default: `3-up`.
+
+### baseHost
+
+Replaces the original host address for viewing in the browser. By default, the original host address is not changed.
+
+### errorPatterns
+
+Error patterns are used:
+
+-   to show more understandable error information if they correspond to patterns for which there is a detailed description;
+-   in the `Group by` display mode with the `error` key selected.
+
+Error patterns can be set either as objects or as strings.
+
+To set the error pattern as an object, use the following format:
+
+```javascript
+{
+    name: '<error name>',
+    pattern: '<error pattern>',
+    hint: '<hint to the user>'
+}
+```
+
+where:
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>name</td><td>String</td><td>Error name.</td></tr>
+<tr><td>pattern</td><td>String or RegExp</td><td>A regular expression or a regular string that the error should match.</td></tr>
+<tr><td>hint</td><td>String</td><td>Optional parameter. A hint of what can be done with this error: why it occurred, how to fix it, etc.</td></tr>
+
+</tbody>
+</table>
+
+If the error pattern is specified as a string, for example: `<error>`, then this string is automatically treated as an object of the form:
+
+```javascript
+{
+    name: '<error>',
+    pattern: '<error>'
+}
+```
+
+This way of setting a pattern is convenient for those errors where `name` and `pattern` are completely the same.
+
+When one of the error patterns matches the error message, then:
+
+-   the `name` of the error template will be displayed as the title of the error message, and the original error message will be hidden under the cut;
+-   the `hint` for the error will be displayed after the error field `stack`. The hint can be specified as an html string. For example, `<div>some-useful-hint</div>`.
+
+In the `Group by` mode with the selected `error` key, the test will be associated with the group if the test error matches the group error pattern. If the test cannot be linked to existing groups, a new group will be created.
+
+### metaInfoBaseUrls
+
+Base URLs for generating links in the `Meta` section based on meta information about the tests run.
+
+The parameter is set as an object:
+
+```javascript
+{
+    '<option-1>': 'value of option 1',
+    '<option-2>': 'value of option 2',
+    // etc.
+}
+```
+
+For example:
+
+```javascript
+{
+    'file': 'base/path'
+}
+```
+
+### saveFormat
+
+**DEPRECATED**
+
+Allows you to set the format in which the results of the tests run will be saved.
+
+Only one value is available now, which is used by default:
+
+-   `sqlite` — save the results of the tests run in the database of SQLite format.
+
+### customGui
+
+**DEPRECATED**
+
+<Admonition type="warning">
+    Instead of customGui, it is recommended to use [report plugins](#plugins).
+</Admonition>
+
+Description of custom controls for GUI mode.
+
+See more in the section "[Customizing GUI](./html-reporter-custom-gui)".
+
+### pluginsEnabled
+
+Enable plugins for `html-reporter`.
+
+### plugins
+
+A list of plugins with their settings.
+
+See more details in the section "[Plugins](./html-reporter-plugins)".
+
+### customScripts
+
+A list of custom scripts in the form of an array of functions. Using this parameter, you can add any script to the html-report page. For example, to collect any metrics or implement additional functionality. The scripts will be executed immediately after rendering the page.
+
+For example:
+
+```javascript
+customScripts: [
+    function () {
+        console.info("some logs");
+    },
+    () => {
+        const div = document.createElement("div");
+        div.innerHTML = "hello";
+        document.body.prepend(div);
+    },
+];
+```
+
+### yandexMetrika
+
+This parameter allows you to add [Yandex.Metrika][yandex-metrika] to the report. The parameter is set as an object with the key `counterNumber`. As the key value, you must specify the Yandex.Metrica counter number (see "[How to create a counter][how-to-create-counter]"). The number should be set as a Number, not a String.
+
+Also, in the Yandex.Metrika interface, go to the _"Counter"_ tab in the settings section, click _"Copy"_ and paste the counter code into the [customScripts](#customscripts) field.
+
+With the help of metrics, you can find out how developers interact with your report and what kind of problems they face.
+
+The report supports the following [goals of metrics][yandex-metrika-goals]:
+
+-   **ACCEPT_SCREENSHOT**—there was a click on the _Accept_ button to accept a screenshot;
+-   **ACCEPT_OPENED_SCREENSHOTS**—there was a click on the _Accept opened_ button to accept screenshots from open tests.
+
+Example of setting up Yandex.Metrika in one of the projects:
+
+```javascript
+module.exports = {
+    plugins: {
+        'html-reporter/testplane': {
+            customScripts: [
+                function(){(function(m,e,t,r,i,k,a){m[i]=m[i]<tr><td>function(){(m[i].a=m[i].a</td></tr>[]).push(arguments)}; m[i].l=1*new Date();k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)}) (window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym"); ym(56782912, "init", { clickmap:true, trackLinks:true, accurateTrackBounce:true, webvisor:true })},
+
+                // other scripts...
+            ],
+            yandexMetrika: {
+                counterNumber: 1234567
+            },
+
+            // other plugin settings...
+        },
+
+        // other testplane plugins...
+    },
+
+    // other testplane settings...
+};
+```
+
+### Passing parameters via the CLI {#setup_by_cli}
+
+All plugin parameters that can be defined in the config can also be passed as command line options or through environment variables during Testplane startup. Use the prefix `--html-reporter-` for command line options and `html_reporter_` for environment variables.
+
+For example, the settings parameter [path](#path) can be passed in the following ways:
+
+```bash
+testplane path/to/mytest.js --html-reporter-path custom/dir
+```
+
+```bash
+html_reporter_path=custom/dir testplane path/to/mytest.js
+```
+
+## Data storage {#data_storage}
+
+As mentioned above, `html-reporter` saves the tests run results to the [SQLite][sqlite] database.
+
+Why do we use SQLite? Because it is:
+
+-   serverless, easy to connect and requires no configuration
+-   cross-platform, runs on any operating system
+-   single-file, easy to reuse reports and share them
+-   faster than if you store the report on the file system
+-   compact and has full SQL.
+
+Files that are created during the execution of tests:
+
+-   `sqlite.db`—Sqlite database with tests run results
+-   `data.js`—report configuration
+-   `databaseUrls.json`—absolute or relative URLs to SQLite databases (`sqlite.db`) and/or URLs of other `databaseUrls.json` files (see command [merge-reports][merge-reports]).
+
+[html-reporter]: https://github.com/gemini-testing/html-reporter
+[testplane]: https://github.com/gemini-testing/testplane
+[sqlite]: https://www.sqlite.org/index.html
+[yandex-metrika]: https://yandex.ru/support/metrica/index.html
+[yandex-metrika-goals]: https://yandex.ru/support/metrica/general/goals.html
+[how-to-create-counter]: https://yandex.ru/support/metrica/general/creating-counter.html
+[merge-reports]: ./html-reporter-commands#merge-reports
+[http-server]: https://github.com/http-party/http-server#http-server-a-simple-static-http-server
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/index.mdx b/i18n/en/docusaurus-plugin-content-docs/current/index.mdx
new file mode 100644
index 0000000..a8d03c4
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/index.mdx
@@ -0,0 +1,7 @@
+---
+sidebar_position: 1
+---
+
+# Overview
+
+**Testplane** — a tool for automating testing of user scenarios in web interfaces.
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/hermione-browser-version-changer.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/hermione-browser-version-changer.mdx
new file mode 100644
index 0000000..bb6ab53
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/hermione-browser-version-changer.mdx
@@ -0,0 +1,104 @@
+# hermione-browser-version-changer
+
+## Overview {#overview}
+
+Use the `hermione-browser-version-changer` plugin to manage the definition of the browser version for tests.
+
+## Install {#install}
+
+```bash
+npm install -D hermione-browser-version-changer
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the `testplane` config:
+
+```javascript
+module.exports = {
+    plugins: {
+        'hermione-browser-version-changer': {
+            enabled: true,
+            initStore: async () => {
+                return {
+                    '70.1': ['title1', 'title2'],
+                    '70.2': ['title3', 'title4']
+                };
+            }
+            browsers: {
+                chrome: {
+                    '70.1': (test, ver, store) => store[ver].includes(test.title),
+                    '70.2': (test, ver, store) => store[ver].includes(test.title)
+                }
+            }
+        },
+
+        // other testplane plugins...
+    },
+
+    // other testplane settings...
+};
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[enabled](#setup_enabled)</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>[initStore](#setup_init_store)</td><td>Function</td><td>_[noop][noop]_</td><td>Function for initializing the storage _(store)_, which will be available in [predicate](#setup_predicate).</td></tr>
+<tr><td>[browsers](#setup_browsers)</td><td>Object</td><td>_N/A_</td><td>A list of browsers and their settings. See details [below](#setup_browsers).</td></tr>
+
+</tbody>
+</table>
+
+### enabled {#setup_enabled}
+
+Enable or disable the plugin. By default: `true`.
+
+### initStore {#setup_init_store}
+
+Optional parameter. Function for initializing the storage _(store)_, which will be available in [predicate](#setup_predicate). The store can be used in [predicate](#setup_predicate) for any test to determine which version of the browser belongs to it. By default: [\_.noop][noop] from [lodash][lodash].
+
+The function can be asynchronous.
+
+### browsers {#setup_browsers}
+
+A list of browsers and their settings. It has the following format:
+
+```javascript
+browsers: {
+    <browser-id>: {
+        <browser-version-1>: <predicate>,
+        <browser-version-2>: <predicate>,
+        // other browser versions...
+    },
+    // other browsers...
+}
+```
+
+### predicate(test, version, store) {#setup_predicate}
+
+A predicate function that receives the test instance _(test),_ browser version _(version)_ and a link to the storage _(store)_. It should return `true` if the test fits the specified browser version, otherwise it should return `false`.
+
+### Passing parameters via the CLI {#setup_cli}
+
+All plugin parameters that can be defined in the config can also be passed as command line options or through environment variables during Testplane startup. Use the prefix `--browser-version-changer-` for command line options and `testplane_browser_version_changer_` for environment variables. For example:
+
+```bash
+npx testplane --browser-version-changer-enabled false
+```
+
+```bash
+testplane_browser_version_changer_enabled=false npx testplane
+```
+
+## Useful links {#useful_links}
+
+-   [hermione-browser-version-changer plugin sources][hermione-browser-version-changer]
+
+[hermione-browser-version-changer]: https://github.com/gemini-testing/hermione-browser-version-changer
+[noop]: https://lodash.com/docs/4.17.15#noop
+[lodash]: https://lodash.com/
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/hermione-hide-scrollbars.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/hermione-hide-scrollbars.mdx
new file mode 100644
index 0000000..0cc9c4e
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/hermione-hide-scrollbars.mdx
@@ -0,0 +1,73 @@
+import Admonition from "@theme/Admonition";
+
+# hermione-hide-scrollbars
+
+## Overview {#overview}
+
+Use the `hermione-hide-scrollbars` plugin to hide scrollbars in tests that run in Chrome browsers.
+
+To access the browser via [Chrome DevTools Protocol (CDP)][CDP], the plugin uses the [puppeteer-core](https://github.com/GoogleChrome/puppeteer) package.
+
+To hide scroll bars, the CDP [Emulation.setScrollbarsHidden][set-scrollbars-hidden] command is used.
+
+<Admonition type="warning">
+    Update your Chrome browser to version 72.1 and higher so that this functionality works in your
+    tests. Since earlier versions of Chrome browsers do not support the
+    _Emulation.setScrollbarsHidden_ command.
+</Admonition>
+
+## Install {#install}
+
+```bash
+npm install -D hermione-hide-scrollbars
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the `testplane` config:
+
+```javascript
+module.exports = {
+    plugins: {
+        "hermione-hide-scrollbars": {
+            enabled: true,
+            browsers: ["chrome"],
+            browserWSEndpoint: ({ sessionId, gridUrl }) =>
+                `ws://${url.parse(gridUrl).host}/devtools/${sessionId}`,
+        },
+
+        // other testplane plugins...
+    },
+
+    // other testplane settings...
+};
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>browsers</td><td>Array</td><td>`[ ]`</td><td>A list of browsers for which the logic of disabling scroll bars will be applied.</td></tr>
+<tr><td>browserWSEndpoint</td><td>Function</td><td>_N/A_</td><td>A function that should return the URL to work with the browser via [CDP][CDP]. To be able to define the URL, the session ID and a link to the grid are passed to the function: the parameters are passed as an object with the keys _sessionId and gridUrl_.</td></tr>
+
+</tbody>
+</table>
+
+### Passing parameters via the CLI {#setup_by_cli}
+
+All plugin parameters that can be defined in the config can also be passed as command-line options or through environment variables during the launch of Testplane. Use the prefix `--hide-scrollbars-` for command line options and `testplane_hide_scrollbars_` for environment variables.
+
+## Useful links {#useful_links}
+
+-   [hermione-hide-scrollbars plugin sources][hermione-hide-scrollbars]
+-   [setScrollbarsHidden][set-scrollbars-hidden]
+-   [createCDPSession](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.target.createcdpsession.md)
+-   [CDPSession class](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.cdpsession.md)
+
+[hermione-hide-scrollbars]: https://github.com/gemini-testing/hermione-hide-scrollbars/
+[set-scrollbars-hidden]: https://chromedevtools.github.io/devtools-protocol/tot/Emulation/#method-setScrollbarsHidden
+[CDP]: https://chromedevtools.github.io/devtools-protocol/
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/retry-limiter.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/retry-limiter.mdx
new file mode 100644
index 0000000..f1cdf92
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/retry-limiter.mdx
@@ -0,0 +1,109 @@
+import Admonition from "@theme/Admonition";
+
+# retry-limiter
+
+## Overview {#overview}
+
+Use the `retry-limiter` plugin to limit the number of retries of failed tests, as well as the time during which retries are allowed.
+
+<Admonition type="tip">
+Use this plugin when running tests in CI.—Since in CI, as a rule, either all the tests of the project are run, or a significant part of them.
+
+Using the _retry-limiter_ plugin for local launches of a few tests is most often impractical, due to their small number and, accordingly, the lack of a significant effect from saving hardware or time for running tests.
+
+</Admonition>
+
+Retries of failed tests is one of the ways to deal with unstable tests. However, there are cases when a lot of tests fail due to infrastructure problems or because the project code was broken (for example, in a pull-request). In such cases, the retries only waste the resources of the servers on which the tests are run, and the developer's time, forcing the developer to wait for the end of the test run, which will obviously fail.
+
+To avoid such scenarios, the `retry-limiter` plugin allows:
+
+-   set the maximum share of retries from the total number of tests;
+-   limit the time during which retries can be used;
+-   reduce the maximum number of retries for all tests if at least one of the tests fails despite all retries.
+
+For example, if 1000 tests are run in the project and the `limit` parameter in the plugin config is set to _0.3,_ then when the tests fail, _300_ retries will be allowed as much as possible.
+
+If the value _600 seconds (10 minutes)_ is still set in the plugin config for the `timeLimit` parameter, then regardless of how many times you can still retry the failed tests, the plugin will disable the retry mechanism after _10 minutes_ after the start of the test run. The latter protects against unreasonable waste of hardware resources for too long test runs.
+
+If Testplane is launched with the `--retry` option, for example, with the value _7_, and at the same time, in the config of the `retry-limiter` plugin, the `setRetriesOnTestFail` parameter is set to _4_, this means the following: if at least one test fails in any of the browsers after _7_ retries, the plugin will consider that some kind of system problem has arisen and it is necessary to reduce the maximum allowed number of retries to the value specified in the `setRetriesOnTestFail` parameter, that is, to _4_. It also allows you to protect yourself from the unreasonable consumption of resources for running tests in case of system problems.
+
+<Admonition type="tip">
+    If you are faced with a situation in your project when the retry mechanism starts to turn off
+    due to exceeding _timeLimit_, then it is not recommended to thoughtlessly increase this time. It
+    is worth figuring out why the tests began to run for too long, and not to waste hardware instead
+    of solving the real problem with the stability of test runs.
+</Admonition>
+
+## Install {#install}
+
+```bash
+npm install -D retry-limiter
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the Testplane config:
+
+```javascript
+module.exports = {
+    plugins: {
+        "retry-limiter": {
+            limit: 0.3, // allow no more than 30% of retries from the total number of tests
+            setRetriesOnTestFail: 4, // descrease number of retries to 4, after the first test fails despite all retries made
+            timeLimit: 600, // after 10 minutes the retries should be turned off
+        },
+
+        // other Testplane plugins...
+    },
+
+    // other Testplane settings...
+};
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>limit</td><td>Number</td><td>1</td><td>The maximum allowed percentage of retries from the total number of tests. It is set as a number in the range from 0 to 1. After exceeding the specified percentage of retries, the retries will be disabled.</td></tr>
+<tr><td>setRetriesOnTestFail</td><td>Number</td><td>Infinity</td><td>The number of retries to which the allowed number of retries should be reduced if at least one test fails, despite all retries.</td></tr>
+<tr><td>timeLimit</td><td>Number</td><td>Infinity</td><td>The time in seconds after which the retries will be disabled.</td></tr>
+
+</tbody>
+</table>
+
+### Passing parameters via the CLI {#setup_by_cli}
+
+All plugin parameters that can be defined in the config can also be passed as command line options or through environment variables during Testplane startup. Use the prefix `--retry-limiter-` for command line options and `retry_limiter_` for environment variables. For example:
+
+```bash
+npx testplane --retry-limiter-time-limit=900
+```
+
+```bash
+retry_limiter_time_limit=900 npx testplane
+```
+
+## Usage {#usage}
+
+When using the plugin in Testplane's logs, you can see the following messages:
+
+```bash
+retry-limiter: will stop retrying tests after 600 seconds
+```
+
+```bash
+retry-limiter: with limit 0.3 will stop retrying tests after 1189 retries
+```
+
+In the first message, the plugin informs about the limitation of the operation time of the retry mechanism.
+In the second message—about limiting the total number of retries.
+
+## Useful links {#useful_links}
+
+-   [retry-limiter plugin sources][retry-limiter]
+
+[retry-limiter]: https://github.com/gemini-testing/retry-limiter
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/stat-reporter.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/stat-reporter.mdx
new file mode 100644
index 0000000..48914f6
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/stat-reporter.mdx
@@ -0,0 +1,196 @@
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+import Admonition from "@theme/Admonition";
+
+# stat-reporter
+
+## Overview {#overview}
+
+Use the [stat-reporter][stat-reporter] plugin to get a report(s) with test run statistics in [testplane][testplane].
+
+The plugin allows you to receive a report both in the console and as an html and/or json file. At the same time, the reports are not mutually exclusive: after running the tests, you can get 3 types of reports at once.
+
+### Report format {#report_format}
+
+In the plugin report, the test run results are split by browsers. The maximum execution time _(Duration)_ in minutes and seconds and the result of running tests _(Status)_ in each browser are also displayed. Such a report allows you to understand which browsers have problems: the most tests do not pass or the execution time has increased dramatically.
+
+By default, only the report in the console is enabled:
+
+```bash
+┌──────────────────────┬────────┬───────┬────────┬────────┬─────────┬─────────┬──────────┐
+│ Browser              │ Status │ Tests │ Passed │ Failed │ Skipped │ Retries │ Duration │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ firefox              │ passed │ 25    │ 24     │ 0      │ 1       │ 0       │ 01:02    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-desktop       │ passed │ 466   │ 464    │ 0      │ 2       │ 4       │ 07:40    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ ipad                 │ passed │ 24    │ 23     │ 0      │ 1       │ 0       │ 01:27    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ iphone               │ passed │ 376   │ 372    │ 0      │ 4       │ 7       │ 07:12    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-phone         │ passed │ 427   │ 421    │ 0      │ 6       │ 14      │ 07:32    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ iphone-dark          │ passed │ 74    │ 72     │ 0      │ 2       │ 4       │ 02:18    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ searchapp-phone      │ passed │ 319   │ 317    │ 0      │ 2       │ 9       │ 10:00    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ safari13             │ passed │ 15    │ 13     │ 0      │ 2       │ 4       │ 02:42    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-desktop-1920  │ passed │ 3     │ 3      │ 0      │ 0       │ 0       │ 00:57    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ iphoneX              │ passed │ 3     │ 3      │ 0      │ 0       │ 0       │ 00:36    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-desktop-dark  │ passed │ 77    │ 77     │ 0      │ 0       │ 5       │ 01:33    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ yandex-browser-phone │ passed │ 1     │ 1      │ 0      │ 0       │ 0       │ 00:28    │
+├──────────────────────┼────────┼───────┼────────┼────────┼─────────┼─────────┼──────────┤
+│ chrome-grid-720      │ passed │ 2     │ 2      │ 0      │ 0       │ 0       │ 00:49    │
+└──────────────────────┴────────┴───────┴────────┴────────┴─────────┴─────────┴──────────┘
+```
+
+<Admonition type="info">
+    If you want to get more functionality, then use [html-reporter][html-reporter] to get a test run
+    report.
+</Admonition>
+
+## Install {#install}
+
+```bash
+npm install -D stat-reporter
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the `testplane` config:
+
+<Tabs>
+<TabItem value="Minimum config" label="Minimum config">
+```javascript
+    module.exports = {
+        plugins: {
+            'stat-reporter': {
+                enabled: true
+                // the report will only be in the console
+            },
+
+            // other testplane plugins...
+        },
+
+        // other testplane settings...
+    };
+    ```
+
+</TabItem>
+
+<TabItem value="Maximum config" label="Maximum config">
+```javascript
+    module.exports = {
+        plugins: {
+            'stat-reporter': {
+                enabled: true,
+                reporters: {
+                    flat: {
+                        enabled: true
+                    },
+                    html: {
+                        enabled: true,
+                        path: 'some/path/to/file.html'
+                        // if you do not specify path, the report will be saved
+                        // in stat-reporter.html in the current working directory
+                    },
+                    json: {
+                        enabled: true,
+                        path: 'some/path/to/file.json'
+                        // if you do not specify path, the report will be saved
+                        // in stat-reporter.json in the current working directory
+                    }
+                }
+            },
+
+            // other testplane plugins...
+        },
+
+        // other testplane settings...
+    };
+    ```
+
+</TabItem>
+
+</Tabs>
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[enabled](#setup_enabled)</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>[reporters](#setup_reporters)</td><td>Object</td><td>_see&nbsp;description_</td><td>Settings for reports with test run statistics. By default, only the report in the console is enabled _(flat)_.</td></tr>
+
+</tbody>
+</table>
+
+### enabled {#setup_enabled}
+
+Enable or disable the plugin. By default: `true`.
+
+### reporters {#setup_reporters}
+
+Optional parameter. Sets the settings for reports with test run statistics.
+
+By default:
+
+```javascript
+{
+    // the statistics report will only be in the console
+    flat: {
+        enabled: true;
+    }
+}
+```
+
+The parameter is an object in which the key determines the type of report, and its value in the form of an object is the corresponding report settings. You can set the following keys:
+
+-   _flat_—for a report in the console;
+-   _html_—for html-report;
+-   _json_—for json-report.
+
+All reports in the settings have an `enabled` parameter of the `Boolean` type, which determines whether the report is enabled or disabled. By default, only the report in the console is enabled.
+
+Also, reports of the type `html` and `json` have an additional parameter `path`—the path to the file to which you want to save the report.
+
+By default, the report is saved in the current working directory to a file `stat-reporter.html` or `stat-reporter.json` depending on the type of report.
+
+### Passing parameters via the CLI {#setup_by_cli}
+
+All plugin parameters that can be defined in the config can also be passed as command line options or through environment variables during Testplane startup. Use the prefix `--stat-reporter-` for command line options and `stat_reporter_` for environment variables. For example:
+
+```bash
+npx testplane --stat-reporter-reporters-html-enabled=true ...
+```
+
+```bash
+stat_reporter_reporters_html_enabled = true npx testplane ...
+```
+
+## Commands {#commands}
+
+### merge-stat-reports {#commands_merge_stat_reports}
+
+The plugin adds the `merge-stat-reports` command to Testplane, with which you can merge several reports into one report in both html and json format. At the same time, the command allows you to get the output of the final reports in two formats at once.
+
+To save the final report in the required format, you need to specify the appropriate option: `--html` or `--json`.
+
+```bash
+npx testplane merge-stat-reports src-report-1.json src-report-2.json --html dest-html-report --json report.json
+```
+
+## Useful links {#useful_links}
+
+-   [stat-reporter plugin sources][stat-reporter]
+
+[stat-reporter]: https://github.com/gemini-testing/stat-reporter
+[html-reporter]: ../html-reporter/html-reporter-setup
+[testplane]: https://github.com/gemini-testing/testplane
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-chunks.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-chunks.mdx
new file mode 100644
index 0000000..1f939f5
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-chunks.mdx
@@ -0,0 +1,112 @@
+import Admonition from "@theme/Admonition";
+
+# testplane-chunks
+
+## Overview {#overview}
+
+Use the [testplane-chunks][testplane-chunks] plugin to run tests in parallel.
+
+If your project has a large number of tests and at the same time there is not enough performance of concrete CI servers to perform all these tests on one server in an acceptable time, then this plugin is for you.
+
+The plugin allows you to run tests in parallel on multiple servers. Thereby speeding up the overall test run. However, the plugin itself does not deal with any kind of orchestration, parallelization of the launch or merging of the resulting separate reports into one final report.
+
+### What does this plugin do then? {#what_does_plugin_do}
+
+The `testplane-chunks` plugin splits **always in the same way** your tests into a given number of chunks and gives testplane to run only the chunk that you specified. The key here is _"always in the same way"_. That is, the operation of splitting into chunks is [idempotent][idempotence].
+
+### What gives idempotence? {#what_does_idempotence_give}
+
+You can setup your CI so as to reuse the results of test runs from separate chunks during a general restart. This will allow you to save time when restarting all tests, since only those chunks that have failed tests will be run.
+
+For example, your project has 1 thousand tests. You have split these tests into 10 chunks of 100 tests each. This means that when you run tests in your pull request, you will have 10 testplanes running simultaneously on 10 servers. Each Testplane will perform 100 tests. In some of these runs, the tests may fail. For example, 2 out of 10 chunks have failed. You decide to restart the test run, hoping that this time the tests will pass. So, when you restart Testplane with the number of the failed chunk, you can be absolutely sure that the `testplane-chunks` plugin will generate exactly the same batch of tests for Testplane as in its last launch.
+
+<Admonition type="warning">
+    When organizing the restart of tests in your CI, remember that in order to **re-use** runs of
+    separate chunks, the initial number of tests, their names, or the number of browsers in which
+    they are run should not change between runs. Otherwise, chunks in the new launch will not be the
+    same as last time. And although formally you will get the same number of chunks as last time,
+    their contents will be different. This means that reusing past results will be incorrect.
+</Admonition>
+
+### How many times will my tests speed up? {#how_much_will_tests_speed_up}
+
+You need to understand that acceleration is possible only due to the fact that tests will be run on more hardware.
+
+If you do not have servers available that could be allocated for the parallel launch of several testplanes at once, then it makes no sense to split the tests into the appropriate number of chunks. If CI waits for a server to be released in order to run the next chunk of tests, then your parallel launch will turn into a sequential one, and you will not get any acceleration. On the contrary, there will be a slowdown due to the overhead of separate launches of Testplane and the merging of the final report.
+
+That is, parallelism — the number of chunks into which you split your tests — must necessarily be provided with the appropriate amount of available hardware.
+
+### And how to get the final report? {#how_to_get_report}
+
+Add to your project the [html-reporter][html-reporter] plugin.
+
+Use the [merge-reports][merge-reports] command, which [html-reporter][html-reporter] adds to testplane's [cli][cli] to merge all the reports obtained in separate chunks into one final report.
+
+## Install {#install}
+
+```bash
+npm install -D testplane-chunks
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the `testplane` config:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-chunks": {
+            count: 7, // Split tests to 7 chunks
+            run: 1, // Run 1st chunk
+        },
+
+        // other testplane plugins...
+    },
+
+    // other testplane settings...
+};
+```
+
+<Admonition type="info">
+    You don't have to set the _run_ parameter in the plugin config, since with parallel launches of
+    Testplane, you will specify your chunk number _(run)_ for each launch. And this number will need
+    to be passed either through a command line option or through an environment variable (see
+    [passing parameters via CLI](#setup_by_cli)).
+</Admonition>
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>count</td><td>Number</td><td>1</td><td>The number of chunks into which the tests should be split.</td></tr>
+<tr><td>run</td><td>Number</td><td>1</td><td>The number of the chunk to run the tests from.</td></tr>
+
+</tbody>
+</table>
+
+### Passing parameters via the CLI {#setup_by_cli}
+
+All plugin parameters that can be defined in the config can also be passed as command-line options or through environment variables during the launch of Testplane. Use the prefix `--chunks-` for command line options and `testplane_chunks_` for environment variables. For example:
+
+```bash
+npx testplane --chunks-count 10 --chunks-run 1 ...
+```
+
+```bash
+testplane_chunks_count=10 testplane_chunks_run=1 npx testplane ...
+```
+
+## Useful links {#useful_links}
+
+-   [testplane-chunks plugin sources][testplane-chunks]
+-   [What is idempotence?][idempotence]
+
+[html-reporter]: ../html-reporter/html-reporter-setup
+[merge-reports]: ../html-reporter/html-reporter-commands#merge_reports
+[testplane-chunks]: https://github.com/gemini-testing/testplane-chunks
+[cli]: https://en.wikipedia.org/wiki/Command-line_interface
+[idempotence]: https://en.wikipedia.org/wiki/Idempotence
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-global-hook.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-global-hook.mdx
new file mode 100644
index 0000000..6429c59
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-global-hook.mdx
@@ -0,0 +1,73 @@
+# testplane-global-hook
+
+## Overview {#overview}
+
+Use the [testplane-global-hook][testplane-global-hook] plugin to bring out the common logic from your tests into special handlers for `beforeEach` and `afterEach` hooks.
+
+Often, before running the next testplane test, you need to do some preliminary setup, for example:
+
+-   clear all cookies;
+-   clean up your local storage;
+-   initialize some test's common variable.
+
+In order not to repeat these actions in each test, you can describe them in the plugin settings as an async-function for the `beforeEach` hook.
+
+Similarly, after completing the basic checks in the testplane test, you may want to always check for errors in the client code, the triggering of the necessary metrics, etc.
+
+In order not to repeat these actions in each test, you can describe them in the plugin settings as an async-function for the `afterEach` hook.
+
+## Install {#install}
+
+```bash
+npm install -D testplane-global-hook
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the `testplane` config:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-global-hook": {
+            beforeEach: async function () {
+                await this.browser.deleteCookie(); // Say, we want to always clear cookies before running a test
+            },
+            afterEach: async function () {
+                await this.browser.execute(function () {
+                    try {
+                        localStorage.clear(); // And always clean up the localStorage after the test is completed
+                    } catch (e) {}
+                });
+            },
+        },
+
+        // other testplane plugins...
+    },
+
+    // other testplane settings...
+};
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>beforeEach</td><td>Function</td><td>null</td><td>Asynchronous function that will be executed before running each test.</td></tr>
+<tr><td>afterEach</td><td>Function</td><td>null</td><td>Asynchronous function that will be executed after each test is completed.</td></tr>
+
+</tbody>
+</table>
+
+## Useful links {#useful_links}
+
+-   [testplane-global-hook plugin sources][testplane-global-hook]
+-   [browser.deleteCookie command](https://webdriver.io/docs/api/webdriver/#deletecookie)
+-   [browser.execute command](https://webdriver.io/docs/api/browser/execute)
+-   [browser.executeAsync command](https://webdriver.io/docs/api/browser/executeAsync)
+
+[testplane-global-hook]: https://github.com/gemini-testing/testplane-global-hook
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-image-minifier.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-image-minifier.mdx
new file mode 100644
index 0000000..bb59d04
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-image-minifier.mdx
@@ -0,0 +1,114 @@
+import Admonition from "@theme/Admonition";
+
+# testplane-image-minifier
+
+## Overview {#overview}
+
+Use the `testplane-image-minifier` plugin to compress images (screenshots) in your tests.
+
+The plugin supports 8 compression levels: from 0 (do not apply compression) to 7 (maximum compression level).
+
+Compression is lossless.
+
+### How does it work? {#how_does_it_work}
+
+At startup, the plugin subscribes to the `UPDATE_REFERENCE` event, which Testplane sends in the following cases:
+
+-   if the user started testplane by passing the `--update-refs` option;
+-   if the user updates or saves screenshots using the [html-reporter][html-reporter] plugin.
+
+When the `UPDATE_REFERENCE` event is received in the `testplane-image-minifier` plugin, it gets a link to the image itself along with the event. Next, the plugin applies a compression algorithm to the received image with the compression level specified in the config. And saves the new image to the file system. After that, the developer can merge the updated files into the main branch of his project.
+
+To compress images, the `testplane-image-minifier` plugin uses the [optipng-bin][optipng-bin] package.
+
+<Admonition type="info">
+    When choosing the compression level for images in your project, remember that you are choosing
+    between the speed and the space that your images will occupy on disk. The higher the compression
+    ratio, the less space your images will occupy on disk, but the tests themselves will take
+    longer. Since before comparing the images in the tests, the system will have to unpack them.
+    Therefore, in order to get an acceptable test run time, match the selected compression ratio
+    with the capacity of the servers on which these tests will be running.
+</Admonition>
+
+## Install {#install}
+
+```bash
+npm install -D testplane-image-minifier
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the `testplane` config:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-image-minifier": {
+            enabled: true, // Enable the plugin.
+            compressionLevel: 7, // Maximum compression level, compression will take some time
+        },
+
+        // other testplane plugins...
+    },
+
+    // other testplane settings...
+};
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>compressionLevel</td><td>Number</td><td>2</td><td>Image compression level: from 0 to 7 (maximum compression level).</td></tr>
+
+</tbody>
+</table>
+
+### Passing parameters via the CLI {#setup_by_cli}
+
+All plugin parameters that can be defined in the config can also be passed as command-line options or through environment variables during the launch of Testplane. Use the prefix `--image-minifier-` for command line options and `testplane_image_minifier_` for environment variables. For example:
+
+```bash
+npx testplane --image-minifier-compression-level 5
+```
+
+```bash
+testplane_image_minifier_compression_level = 5 npx testplane
+```
+
+## Debugging {#debugging}
+
+Set the environment variable `DEBUG=testplane:image-minifier` to see messages in the console about the application of the compression algorithm for images in tests.
+
+```bash
+DEBUG=testplane:image-minifier npx testplane --update-refs
+```
+
+An example of how it will look in the console:
+
+```bash
+/path/to/reference/image.png compressed by 30%
+```
+
+## Usage {#usage}
+
+After adding the plugin to the project and configuring its parameters, run testplane with the `--update-refs` option:
+
+```bash
+npx testplane --update-refs
+```
+
+The images on the file system will be updated.
+
+## Useful links {#useful_links}
+
+-   [testplane-image-minifier plugin sources][testplane-image-minifier]
+-   [optipng-bin package to compress images][optipng-bin]
+
+[testplane-image-minifier]: https://github.com/gemini-testing/testplane-image-minifier/
+[html-reporter]: ./html-reporter
+[optipng-bin]: https://www.npmjs.com/package/optipng-bin
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-retry-command.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-retry-command.mdx
new file mode 100644
index 0000000..463b8a9
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-retry-command.mdx
@@ -0,0 +1,122 @@
+import Admonition from "@theme/Admonition";
+
+# testplane-retry-command
+
+## Overview {#overview}
+
+Use the `testplane-retry-command` plugin to retry commands at low level.
+
+## Install {#install}
+
+```bash
+npm install -D testplane-retry-command
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the `testplane` config:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-retry-command": {
+            enabled: true,
+            rules: [
+                {
+                    condition: "blank-screenshot",
+                    browsers: ["MicrosoftEdge"],
+                    retryCount: 5,
+                    retryInterval: 120,
+                },
+                {
+                    condition: "assert-view-failed",
+                    browsers: ["Chrome"],
+                    retryCount: 1,
+                    retryOnlyFirst: true,
+                },
+            ],
+        },
+
+        // other testplane plugins...
+    },
+
+    // other testplane settings...
+};
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>rules</td><td>Array</td><td>_N/A_</td><td>A set of rules according to which commands will be retried. Required parameter.</td></tr>
+
+</tbody>
+</table>
+
+### rules {#setup_rules}
+
+The `rules` parameter is an array of objects. Each object describes a separate rule for retrying commands.
+
+Parameters this rule consists of:
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[condition](#setup_rules_condition)</td><td>String</td><td>_N/A_</td><td>Condition to retry: _blank-screenshot_ or _assert-view-failed_. For more information, see below.</td></tr>
+<tr><td>[browsers](#setup_rules_browsers)</td><td>String/RegExp/Array</td><td>/.*/</td><td>A list of browsers in which retries should run.</td></tr>
+<tr><td>[retryCount](#setup_rules_retry_count)</td><td>Number</td><td>2</td><td>The number of retries.</td></tr>
+<tr><td>[retryInterval](#setup_rules_retry_interval)</td><td>Number</td><td>100</td><td>Delay before each retry, in ms.</td></tr>
+<tr><td>[retryOnlyFirst](#setup_rules_retry_only_first)</td><td>Boolean</td><td>false</td><td>Retry only the first command in the test. This option is applied only at the _assert-view-failed_ condition.</td></tr>
+
+</tbody>
+</table>
+
+### condition {#setup_rules_condition}
+
+The condition under which you need to retry. There are 2 values available:
+
+-   `blank-screenshot` — retry the low-level screenshot command [takeScreenshot][take-screenshot] if an empty screenshot is returned as a result of the command;
+-   `assert-view-failed` — retry testplane's high-level command [assertView][assert-view] to take a screenshot if it failed.
+
+### browsers {#setup_rules_browsers}
+
+A list of browsers in which you need to apply low-level retries for commands. It can be set as a string (if it is one browser), a regular expression, or an array of strings/regular expressions. By default, the `browsers` parameter has the value `/.*/`, which all browsers fall under.
+
+### retryCount {#setup_rules_retry_count}
+
+The parameter determines how many times the command needs to be retried if the condition specified in the `condition` parameter is met.
+
+### retryInterval {#setup_rules_retry_interval}
+
+The parameter specifies the time in milliseconds to wait before trying to repeat the command again.
+
+<Admonition type="warning">
+    Be careful when setting a value for this parameter, as too large a value can dramatically reduce
+    the speed of your tests.
+</Admonition>
+
+### retryOnlyFirst {#setup_rules_retry_only_first}
+
+Allows to retry only the first `assertView` command in the test if the value is set to `true`. This parameter is not used for other conditions.
+
+### Passing parameters via the CLI {#setup_by_cli}
+
+All plugin parameters that can be defined in the config can also be passed as command-line options or through environment variables during the launch of Testplane. Use the prefix `--retry-command-` for command line options and `testplane_retry_command_` for environment variables. For example:
+
+```bash
+npx testplane --retry-command-count 3
+```
+
+```bash
+testplane_retry_command_count=3 npx testplane
+```
+
+[testplane-retry-command]: https://github.com/gemini-testing/testplane-retry-command
+[take-screenshot]: https://webdriver.io/docs/api/webdriver/#takescreenshot
+[assert-view]: ../reference/tests-api#command_assert_view
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-retry-progressive.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-retry-progressive.mdx
new file mode 100644
index 0000000..4859efa
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-retry-progressive.mdx
@@ -0,0 +1,104 @@
+# testplane-retry-progressive
+
+## Overview {#overview}
+
+Use the `testplane-retry-progressive` plugin to additionally retry tests if the errors with which they fail correspond to a given set of patterns.
+
+What might it be needed for?
+
+Tests can fail not only because of developer errors, races between scripts executed on a web page, but also for infrastructural reasons. For example, when the network blinks, the browser is not given in time, temporary problems with DNS, etc.
+
+<details>
+    <summary>See examples of patterns for such errors</summary>* Browser request was cancelled * A
+    window size operation failed because the window is not currently available * chrome not
+    reachable * Tried to run command without establishing a connection * No such driver * no such
+    window * Session timed out or not found * Reached error page * getaddrinfo ENOTFOUND * Browsing
+    context has been discarded * Cannot launch browser * Failed to decode response from marionette *
+    session deleted because of page crash * Couldn't connect to selenium server
+</details>
+
+## Install {#install}
+
+```bash
+npm install -D testplane-retry-progressive
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the `testplane` config:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-retry-progressive": {
+            enabled: true,
+            extraRetry: 7,
+            errorPatterns: [
+                "Parameter .* must be a string",
+                {
+                    name: "Cannot read property of undefined",
+                    pattern: "Cannot read property .* of undefined",
+                },
+            ],
+        },
+
+        // other testplane plugins...
+    },
+
+    // other testplane settings...
+};
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>extraRetry</td><td>Number</td><td>5</td><td>The number of times you need to retry the test if it crashes with an error that matches one of the _errorPatterns_.</td></tr>
+<tr><td>errorPatterns</td><td>Array</td><td>`[ ]`</td><td>A list of patterns, one of which an error should match in order for the plugin to retry the test. For more information, see below.</td></tr>
+
+</tbody>
+</table>
+
+### errorPatterns {#setup_error_patterns}
+
+Each pattern in the `errorPatterns` array is either an object of the form:
+
+```javascript
+{
+    name: 'A clear message for the user that will be output to the console',
+    pattern: 'An error pattern that can be set, among other things, as a string for a regular expression'
+}
+```
+
+or a string that will be interpreted by the plugin as an object of the form:
+
+```javascript
+{
+    name: 'your string',
+    pattern: 'your string'
+}
+```
+
+The latter option is convenient if the readable format for the console and the error pattern completely match.
+
+### Passing parameters via the CLI {#setup_by_cli}
+
+All plugin parameters that can be defined in the config can also be passed as command-line options or through environment variables during the launch of Testplane. Use the prefix `--retry-progressive-` for command line options and `testplane_retry_progressive_` for environment variables. For example:
+
+```bash
+npx testplane --retry-progressive-extra-retry 3
+```
+
+```bash
+testplane_retry_progressive_extra_retry=3 npx testplane
+```
+
+## Useful links {#useful_links}
+
+-   [Исходники плагина testplane-retry-progressive][testplane-retry-progressive]
+
+[testplane-retry-progressive]: https://github.com/gemini-testing/testplane-retry-progressive
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-test-repeater.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-test-repeater.mdx
new file mode 100644
index 0000000..7a3b5c4
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/testplane-test-repeater.mdx
@@ -0,0 +1,80 @@
+# testplane-test-repeater
+
+## Overview {#overview}
+
+Use the [testplane-test-repeater][testplane-test-repeater] plugin to run the same test (or group of tests) the required number of times.
+
+This plugin can be useful in cases when you need to make sure that the written tests are stable. The plugin guarantees that the tests will be run as many times as you set, regardless of the results of their run in each attempt. In addition, the plugin allows you to run tests every time in a new browser session. This eliminates the impact of browser degradation or any other side effects that could occur during repeated runs in the same browser session.
+
+## Install {#install}
+
+```bash
+npm install -D testplane-test-repeater
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the `testplane` config:
+
+```javascript
+module.exports = {
+    plugins: {
+        "testplane-test-repeater": {
+            enabled: true,
+            repeat: 50,
+            minRepeat: 10,
+            maxRepeat: 100,
+            uniqSession: true,
+        },
+
+        // other testplane plugins...
+    },
+
+    // other testplane settings...
+};
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>enabled</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>repeat</td><td>Number</td><td>0</td><td>How many times you need to run the test, regardless of the result of its run.</td></tr>
+<tr><td>minRepeat</td><td>Number</td><td>0</td><td>The minimum number of times the test can be run.</td></tr>
+<tr><td>maxRepeat</td><td>Number</td><td>Infinity</td><td>The maximum number of times the test can be run.</td></tr>
+<tr><td>uniqSession</td><td>Boolean</td><td>true</td><td>Run each test in a unique browser session.</td></tr>
+
+</tbody>
+</table>
+
+### Passing parameters via the CLI {#setup_by_cli}
+
+All plugin parameters that can be defined in the config can also be passed as command line options or through environment variables during Testplane startup. Use the prefix `--test-repeater-` for command line options and `testplane_test_repeater_` for environment variables. For example:
+
+```bash
+npx testplane --test-repeater-repeat 5
+```
+
+```bash
+testplane_test_repeater_repeat=5 npx testplane
+```
+
+## Usage {#usage}
+
+### Option --repeat {#usage_option_repeat}
+
+The plugin also adds a special `--repeat` option to Testplane's [CLI][cli], with which you can run the test the right number of times in a more convenient way. For example:
+
+```bash
+npx testplane --repeat 5
+```
+
+## Useful links {#useful_links}
+
+-   [testplane-test-repeater plugin sources][testplane-test-repeater]
+
+[testplane-test-repeater]: https://github.com/gemini-testing/testplane-test-repeater
+[cli]: https://en.wikipedia.org/wiki/Command-line_interface
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/plugins/url-decorator.mdx b/i18n/en/docusaurus-plugin-content-docs/current/plugins/url-decorator.mdx
new file mode 100644
index 0000000..61facb7
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/plugins/url-decorator.mdx
@@ -0,0 +1,329 @@
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+import Admonition from "@theme/Admonition";
+
+# url-decorator
+
+## Overview {#overview}
+
+Use the [url-decorator][url-decorator] plugin to automatically add the necessary query parameters to the urls in Testplane tests.
+
+## Install {#install}
+
+```bash
+npm install -D url-decorator
+```
+
+## Setup {#setup}
+
+Add the plugin to the `plugins` section of the `testplane` config:
+
+```javascript
+module.exports = {
+    plugins: {
+        "url-decorator": {
+            enabled: true,
+            url: {
+                query: [
+                    {
+                        name: "text",
+                        value: "foo",
+                    },
+
+                    // other query parameters...
+                ],
+            },
+        },
+
+        // other testplane plugins...
+    },
+
+    // other testplane settings...
+};
+```
+
+### Description of configuration parameters {#setup_description}
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[enabled](#setup_enabled)</td><td>Boolean</td><td>true</td><td>Enable / disable the plugin.</td></tr>
+<tr><td>[url](#setup_url)</td><td>Object</td><td>_N/A_</td><td>An object with a description of query parameters that should be added to each url in the test.</td></tr>
+
+</tbody>
+</table>
+
+### enabled {#setup_enabled}
+
+Enable or disable the plugin. By default: `true`.
+
+### url {#setup_url}
+
+The `url` parameter is an object with a `query` field, the value of which can be either an array or an object.
+
+<Tabs>
+<TabItem value="query as an array" label="query as an array">
+```javascript
+    module.exports = {
+        plugins: {
+            'url-decorator': {
+                enabled: true,
+                url: {
+                    query: [
+                        {
+                            name: '<param-1>', // specify the name of the query parameter
+                            value: '<param-1-value>', // specify the value of the query parameter
+                            mode: 'concat', // or 'override'
+                            browsers: /.*/ // by default: for all browsers
+                        },
+                        {
+                            name: '<param-2>', // specify the name of the query parameter
+                            value: '<param-2-value>', // specify the value of the query parameter
+                            mode: 'concat', // or 'override'
+                            browsers: /.*/ // by default: for all browsers
+                        },
+
+                        // other query parameters...
+                    ]
+                }
+            },
+
+            // other testplane plugins...
+        },
+
+        // other testplane settings...
+    };
+    ```
+
+</TabItem>
+
+<TabItem value="query as an object" label="query as an object">
+```javascript
+    module.exports = {
+        plugins: {
+            'url-decorator': {
+                enabled: true,
+                url: {
+                    query: {
+                        '<param-1>': { // specify the name of the query parameter
+                            value: '<param-1-value>', // specify the value of the query parameter
+                            mode: 'concat', // or 'override'
+                            browsers: /.*/ // by default: for all browsers
+                        },
+                        '<param-2>': { // specify the name of the query parameter
+                            value: '<param-2-value>', // specify the value of the query parameter
+                            mode: 'concat', // or 'override'
+                            browsers: /.*/ // by default: for all browsers
+                        },
+
+                        // other query parameters...
+                    }
+                },
+            },
+
+            // other testplane plugins...
+        },
+
+        // other testplane settings...
+    };
+    ```
+
+</TabItem>
+
+</Tabs>
+
+Here the query parameter is an object with the following fields:
+
+<table>
+<thead>
+<tr><td>**Parameter**</td><td>**Type**</td><td>**Default&nbsp;value**</td><td>**Description**</td></tr>
+</thead>
+<tbody>
+<tr><td>[name](#setup_query_param_name)</td><td>String</td><td>_N/A_</td><td>Name of the query parameter. If _query_ is set as an object, then this field is not specified, since the key itself is the name of the query parameter.</td></tr>
+<tr><td>[value](#setup_query_param_value)</td><td>String or Number or Array</td><td>_N/A_</td><td>The value of the query parameter.</td></tr>
+<tr><td>[mode](#setup_query_param_mode)</td><td>String</td><td>"concat"</td><td>The mode of combining parameters: _concat_ or _override_.</td></tr>
+<tr><td>[browsers](#setup_query_param_browsers)</td><td>String or RegExp or Array</td><td>_N/A_</td><td>The list of browsers to which the query parameter will be applied.</td></tr>
+
+</tbody>
+</table>
+
+#### name {#setup_query_param_name}
+
+Name of the query parameter. If `query` is set as an object, then this field is not specified, since the key itself is the name of the query parameter.
+
+#### value {#setup_query_param_value}
+
+The value of the query parameter. It can be specified as a string, a number, or an array of strings and/or numbers.
+
+#### mode {#setup_query_param_mode}
+
+The mode of combining parameters. There are 2 possible values: `concat` _(concat parameters)_ and `override` _(override parameters)_. By default: `concat`.
+
+**Concat mode**
+
+For example:
+
+-   you want to add the query parameter `nick`, which is already in the test url: `http://localhost/test/?nick=bilbo`;
+-   at the same time, you do not want the additional value of the `nick` parameter to erase the value that is already in the url.
+
+In this case, you need to specify `mode: 'concat'` for the parameter or not specify `mode` at all (using the default mode):
+
+```javascript
+url: {
+    query: [
+        {
+            name: "nick",
+            value: "torin",
+            mode: "concat", // or skip it as the default mode is 'concat'
+        },
+    ];
+}
+```
+
+Then the resulting url in the test will be: `http://localhost/test/?nick=bilbo&nick=torin`.
+
+You can also specify an array of values for the `nick` parameter in the `value` value:
+
+```javascript
+url: {
+    query: [
+        {
+            name: "nick",
+            value: ["torin", "gloin"],
+            mode: "concat", // or skip it as the default mode is 'concat'
+        },
+    ];
+}
+```
+
+Then the resulting url in the test will be: `http://localhost/test/?nick=bilbo&nick=torin&nick=gloin`.
+
+**Override mode**
+
+If you want to erase the `nick` parameter, then you need to set the `override` mode:
+
+```javascript
+url: {
+    query: [
+        {
+            name: "nick",
+            value: "torin",
+            mode: "override",
+        },
+    ];
+}
+```
+
+Then the resulting url in the test will be: `http://localhost/test/?nick=torin`.
+
+#### browsers {#setup_query_param_browsers}
+
+A browser or a list of browsers, or a regular expression pattern for browsers to which the specified query parameters should be applied. If the parameter `browsers` is not specified, the query parameters will be applied for all browsers.
+
+Below are examples of setting the `browsers` parameter in all ways:
+
+<Tabs>
+<TabItem value="string" label="string">
+```javascript
+    url: {
+        query: [
+            {
+                name: 'nick',
+                value: 'gloin',
+                browsers: 'firefox'
+            }
+        ]
+    }
+    ```
+</TabItem>
+
+<TabItem value="array of strings" label="array of strings">
+```javascript
+    url: {
+        query: [
+            {
+                name: 'nick',
+                value: 'gloin',
+                browsers: ['firefox', 'chrome']
+            }
+        ]
+    }
+    ```
+</TabItem>
+
+<TabItem value="regexp" label="regexp">
+```javascript
+    url: {
+        query: [
+            {
+                name: 'nick',
+                value: 'gloin',
+                browsers: /ie-\d+/  //ie-8, ie-9, ie-10, ...
+            }
+        ]
+    }
+    ```
+</TabItem>
+
+<TabItem value="array of regexp / strings" label="array of regexp / strings">
+```javascript
+    url: {
+        query: [
+            {
+                name: 'nick',
+                value: 'gloin',
+                browsers: [/ie-\d+/, 'firefox']
+            }
+        ]
+    }
+    ```
+</TabItem>
+
+</Tabs>
+
+### Passing parameters via the CLI {#setup_by_cli}
+
+#### HERMIONE*URL_QUERY*\*
+
+To pass additional query parameters, you can use environment variables of the following type:
+
+```bash
+HERMIONE_URL_QUERY_<query parameter name>
+```
+
+For example, your test opens the url `http://localhost/test/?tool=testplane`, and you want to add the query parameter `text` with the value `ololo` to the url using the environment variable:
+
+```bash
+HERMIONE_URL_QUERY_TEXT=ololo testplane ...
+```
+
+After that, your test will open the url of the following form: `http://localhost/test/?tool=testplane&text=ololo`.
+
+#### HERMIONE_URL_CUSTOM_QUERIES
+
+If there are parameters among your query parameters that cannot be expressed as an environment variable (for example, `foo-bar`), then you can add these parameters via the environment variable `HERMIONE_URL_CUSTOM_QUERIES`.
+
+As a value, use a string of the form `<query-param-1>=<value-1>;<query-param-2>=<value-2>;`.
+
+For example:
+
+```bash
+HERMIONE_URL_CUSTOM_QUERIES='foo-bar=baz;qux=1' testplane ...
+```
+
+Then your test will open the url of the following form: `http://localhost/test/?foo-bar=baz&qux=1`.
+
+<Admonition type="warning">
+    Environment variables have a higher priority than the values of the corresponding variables in
+    the plugin config.
+</Admonition>
+
+## Useful links {#useful_links}
+
+-   [url-decorator plugin sources][url-decorator]
+
+[url-decorator]: https://github.com/gemini-testing/url-decorator
+[internal-url-decorator]: ../plugins/internal-url-decorator
diff --git a/i18n/en/docusaurus-theme-classic/footer.json b/i18n/en/docusaurus-theme-classic/footer.json
new file mode 100644
index 0000000..be1ba9a
--- /dev/null
+++ b/i18n/en/docusaurus-theme-classic/footer.json
@@ -0,0 +1,54 @@
+{
+    "link.title.Quickstart": {
+        "message": "Quickstart",
+        "description": "The title of the footer links column with title=Quickstart in the footer"
+    },
+    "link.title.Core concepts": {
+        "message": "Core concepts",
+        "description": "The title of the footer links column with title=Core concepts in the footer"
+    },
+    "link.title.Customization": {
+        "message": "Customization",
+        "description": "The title of the footer links column with title=Customization in the footer"
+    },
+    "link.title.Resources": {
+        "message": "Resources",
+        "description": "The title of the footer links column with title=Resources in the footer"
+    },
+    "link.item.label.Installation": {
+        "message": "Installation",
+        "description": "The label of footer link with label=Installation linking to #"
+    },
+    "link.item.label.Why testplane?": {
+        "message": "Why testplane?",
+        "description": "The label of footer link with label=Why testplane? linking to #"
+    },
+    "link.item.label.Browser commands": {
+        "message": "Browser commands",
+        "description": "The label of footer link with label=Browser commands linking to #"
+    },
+    "link.item.label.Testplane config": {
+        "message": "Testplane config",
+        "description": "The label of footer link with label=Testplane config linking to #"
+    },
+    "link.item.label.Testplane UI": {
+        "message": "Testplane UI",
+        "description": "The label of footer link with label=Testplane UI linking to #"
+    },
+    "link.item.label.Docs": {
+        "message": "Docs",
+        "description": "The label of footer link with label=Docs linking to #"
+    },
+    "link.item.label.Blog": {
+        "message": "Blog",
+        "description": "The label of footer link with label=Blog linking to #"
+    },
+    "link.item.label.Changelog": {
+        "message": "Changelog",
+        "description": "The label of footer link with label=Changelog linking to #"
+    },
+    "copyright": {
+        "message": "MIT License © 2024",
+        "description": "The footer copyright"
+    }
+}
diff --git a/i18n/en/docusaurus-theme-classic/navbar.json b/i18n/en/docusaurus-theme-classic/navbar.json
new file mode 100644
index 0000000..bf677ee
--- /dev/null
+++ b/i18n/en/docusaurus-theme-classic/navbar.json
@@ -0,0 +1,18 @@
+{
+    "title": {
+        "message": "testplane",
+        "description": "The title in the navbar"
+    },
+    "item.label.Docs": {
+        "message": "Docs",
+        "description": "Navbar item with label Docs"
+    },
+    "item.label.Blog": {
+        "message": "Blog",
+        "description": "Navbar item with label Blog"
+    },
+    "item.label.GitHub": {
+        "message": "GitHub",
+        "description": "Navbar item with label GitHub"
+    }
+}
diff --git a/i18n/ru/code.json b/i18n/ru/code.json
new file mode 100644
index 0000000..0683872
--- /dev/null
+++ b/i18n/ru/code.json
@@ -0,0 +1,547 @@
+{
+    "versionsPage.versionEntry.link": {
+        "message": "Documentation"
+    },
+    "versionsPage.versionEntry.releaseNotes": {
+        "message": "Release Notes"
+    },
+    "versionsPage.title": {
+        "message": "Testplane versions"
+    },
+    "versionsPage.current.title": {
+        "message": "Current version (Stable)"
+    },
+    "versionsPage.current.description": {
+        "message": "Here you can find the documentation for current released version."
+    },
+    "versionsPage.next.title": {
+        "message": "Next version (Unreleased)"
+    },
+    "versionsPage.next.description": {
+        "message": "Here you can find the documentation for work-in-process unreleased version."
+    },
+    "theme.ErrorPageContent.title": {
+        "message": "На странице произошёл сбой.",
+        "description": "The title of the fallback page when the page crashed"
+    },
+    "theme.BackToTopButton.buttonAriaLabel": {
+        "message": "Прокрутка к началу",
+        "description": "The ARIA label for the back to top button"
+    },
+    "theme.blog.archive.title": {
+        "message": "Архив",
+        "description": "The page & hero title of the blog archive page"
+    },
+    "theme.blog.archive.description": {
+        "message": "Архив",
+        "description": "The page & hero description of the blog archive page"
+    },
+    "theme.blog.paginator.navAriaLabel": {
+        "message": "Навигация по странице списка блогов",
+        "description": "The ARIA label for the blog pagination"
+    },
+    "theme.blog.paginator.newerEntries": {
+        "message": "Следующие записи",
+        "description": "The label used to navigate to the newer blog posts page (previous page)"
+    },
+    "theme.blog.paginator.olderEntries": {
+        "message": "Предыдущие записи",
+        "description": "The label used to navigate to the older blog posts page (next page)"
+    },
+    "theme.blog.post.paginator.navAriaLabel": {
+        "message": "Навигация по странице поста блога",
+        "description": "The ARIA label for the blog posts pagination"
+    },
+    "theme.blog.post.paginator.newerPost": {
+        "message": "Следующий пост",
+        "description": "The blog post button label to navigate to the newer/previous post"
+    },
+    "theme.blog.post.paginator.olderPost": {
+        "message": "Предыдущий пост",
+        "description": "The blog post button label to navigate to the older/next post"
+    },
+    "theme.blog.post.plurals": {
+        "message": "{count} запись|{count} записи|{count} записей",
+        "description": "Pluralized label for \"{count} posts\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)"
+    },
+    "theme.blog.tagTitle": {
+        "message": "{nPosts} с тегом \"{tagName}\"",
+        "description": "The title of the page for a blog tag"
+    },
+    "theme.tags.tagsPageLink": {
+        "message": "Посмотреть все теги",
+        "description": "The label of the link targeting the tag list page"
+    },
+    "theme.colorToggle.ariaLabel": {
+        "message": "Переключение между темным и светлым режимом (сейчас используется {mode})",
+        "description": "The ARIA label for the navbar color mode toggle"
+    },
+    "theme.colorToggle.ariaLabel.mode.dark": {
+        "message": "Тёмный режим",
+        "description": "The name for the dark color mode"
+    },
+    "theme.colorToggle.ariaLabel.mode.light": {
+        "message": "Светлый режим",
+        "description": "The name for the light color mode"
+    },
+    "theme.docs.breadcrumbs.navAriaLabel": {
+        "message": "Навигационная цепочка текущей страницы",
+        "description": "The ARIA label for the breadcrumbs"
+    },
+    "theme.docs.DocCard.categoryDescription.plurals": {
+        "message": "{count} элемент|{count} элемента|{count} элементов",
+        "description": "The default description for a category card in the generated index about how many items this category includes"
+    },
+    "theme.docs.paginator.navAriaLabel": {
+        "message": "Страница документа",
+        "description": "The ARIA label for the docs pagination"
+    },
+    "theme.docs.paginator.previous": {
+        "message": "Предыдущая страница",
+        "description": "The label used to navigate to the previous doc"
+    },
+    "theme.docs.paginator.next": {
+        "message": "Следующая страница",
+        "description": "The label used to navigate to the next doc"
+    },
+    "theme.docs.tagDocListPageTitle.nDocsTagged": {
+        "message": "Одна страница|{count} страницы|{count} страниц",
+        "description": "Pluralized label for \"{count} docs tagged\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)"
+    },
+    "theme.docs.tagDocListPageTitle": {
+        "message": "{nDocsTagged} с тегом \"{tagName}\"",
+        "description": "The title of the page for a docs tag"
+    },
+    "theme.docs.versionBadge.label": {
+        "message": "Версия: {versionLabel}"
+    },
+    "theme.docs.versions.unreleasedVersionLabel": {
+        "message": "Это документация для будущей версии {siteTitle} {versionLabel}.",
+        "description": "The label used to tell the user that he's browsing an unreleased doc version"
+    },
+    "theme.docs.versions.unmaintainedVersionLabel": {
+        "message": "Это документация {siteTitle} для версии {versionLabel}, которая уже не поддерживается.",
+        "description": "The label used to tell the user that he's browsing an unmaintained doc version"
+    },
+    "theme.docs.versions.latestVersionSuggestionLabel": {
+        "message": "Актуальная документация находится на странице {latestVersionLink} ({versionLabel}).",
+        "description": "The label used to tell the user to check the latest version"
+    },
+    "theme.docs.versions.latestVersionLinkLabel": {
+        "message": "последней версии",
+        "description": "The label used for the latest version suggestion link label"
+    },
+    "theme.common.editThisPage": {
+        "message": "Отредактировать эту страницу",
+        "description": "The link label to edit the current page"
+    },
+    "theme.common.headingLinkTitle": {
+        "message": "Прямая ссылка на {heading}",
+        "description": "Title for link to heading"
+    },
+    "theme.lastUpdated.atDate": {
+        "message": " {date}",
+        "description": "The words used to describe on which date a page has been last updated"
+    },
+    "theme.lastUpdated.byUser": {
+        "message": " от {user}",
+        "description": "The words used to describe by who the page has been last updated"
+    },
+    "theme.lastUpdated.lastUpdatedAtBy": {
+        "message": "Последнее обновление{atDate}{byUser}",
+        "description": "The sentence used to display when a page has been last updated, and by who"
+    },
+    "theme.NotFound.title": {
+        "message": "Страница не найдена",
+        "description": "The title of the 404 page"
+    },
+    "theme.navbar.mobileVersionsDropdown.label": {
+        "message": "Версии",
+        "description": "The label for the navbar versions dropdown on mobile view"
+    },
+    "theme.tags.tagsListLabel": {
+        "message": "Теги:",
+        "description": "The label alongside a tag list"
+    },
+    "theme.AnnouncementBar.closeButtonAriaLabel": {
+        "message": "Закрыть",
+        "description": "The ARIA label for close button of announcement bar"
+    },
+    "theme.admonition.caution": {
+        "message": "предупреждение",
+        "description": "The default label used for the Caution admonition (:::caution)"
+    },
+    "theme.admonition.danger": {
+        "message": "осторожно",
+        "description": "The default label used for the Danger admonition (:::danger)"
+    },
+    "theme.admonition.info": {
+        "message": "к сведению",
+        "description": "The default label used for the Info admonition (:::info)"
+    },
+    "theme.admonition.note": {
+        "message": "примечание",
+        "description": "The default label used for the Note admonition (:::note)"
+    },
+    "theme.admonition.tip": {
+        "message": "подсказка",
+        "description": "The default label used for the Tip admonition (:::tip)"
+    },
+    "theme.admonition.warning": {
+        "message": "warning",
+        "description": "The default label used for the Warning admonition (:::warning)"
+    },
+    "theme.blog.sidebar.navAriaLabel": {
+        "message": "Навигация по последним постам в блоге",
+        "description": "The ARIA label for recent posts in the blog sidebar"
+    },
+    "theme.CodeBlock.copied": {
+        "message": "Скопировано",
+        "description": "The copied button label on code blocks"
+    },
+    "theme.CodeBlock.copyButtonAriaLabel": {
+        "message": "Скопировать в буфер обмена",
+        "description": "The ARIA label for copy code blocks button"
+    },
+    "theme.CodeBlock.copy": {
+        "message": "Скопировать",
+        "description": "The copy button label on code blocks"
+    },
+    "theme.CodeBlock.wordWrapToggle": {
+        "message": "Переключить перенос по строкам",
+        "description": "The title attribute for toggle word wrapping button of code block lines"
+    },
+    "theme.DocSidebarItem.expandCategoryAriaLabel": {
+        "message": "Expand sidebar category '{label}'",
+        "description": "The ARIA label to expand the sidebar category"
+    },
+    "theme.DocSidebarItem.collapseCategoryAriaLabel": {
+        "message": "Collapse sidebar category '{label}'",
+        "description": "The ARIA label to collapse the sidebar category"
+    },
+    "theme.NavBar.navAriaLabel": {
+        "message": "Main",
+        "description": "The ARIA label for the main navigation"
+    },
+    "theme.NotFound.p1": {
+        "message": "К сожалению, мы не смогли найти запрашиваемую вами страницу.",
+        "description": "The first paragraph of the 404 page"
+    },
+    "theme.NotFound.p2": {
+        "message": "Пожалуйста, обратитесь к владельцу сайта, с которого вы перешли на эту ссылку, чтобы сообщить ему, что ссылка не работает.",
+        "description": "The 2nd paragraph of the 404 page"
+    },
+    "theme.navbar.mobileLanguageDropdown.label": {
+        "message": "Языки",
+        "description": "The label for the mobile language switcher dropdown"
+    },
+    "theme.TOCCollapsible.toggleButtonLabel": {
+        "message": "Содержание этой страницы",
+        "description": "The label used by the button on the collapsible TOC component"
+    },
+    "theme.blog.post.readMore": {
+        "message": "Читать дальше",
+        "description": "The label used in blog post item excerpts to link to full blog posts"
+    },
+    "theme.blog.post.readMoreLabel": {
+        "message": "Подробнее о {title}",
+        "description": "The ARIA label for the link to full blog posts from excerpts"
+    },
+    "theme.blog.post.readingTime.plurals": {
+        "message": "{readingTime} мин. чтения|{readingTime} мин. чтения|{readingTime} мин. чтения",
+        "description": "Pluralized label for \"{readingTime} min read\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)"
+    },
+    "theme.docs.breadcrumbs.home": {
+        "message": "Главная страница",
+        "description": "The ARIA label for the home page in the breadcrumbs"
+    },
+    "theme.docs.sidebar.collapseButtonTitle": {
+        "message": "Свернуть сайдбар",
+        "description": "The title attribute for collapse button of doc sidebar"
+    },
+    "theme.docs.sidebar.collapseButtonAriaLabel": {
+        "message": "Свернуть сайдбар",
+        "description": "The title attribute for collapse button of doc sidebar"
+    },
+    "theme.docs.sidebar.navAriaLabel": {
+        "message": "Docs sidebar",
+        "description": "The ARIA label for the sidebar navigation"
+    },
+    "theme.docs.sidebar.closeSidebarButtonAriaLabel": {
+        "message": "Закрыть панель навигации",
+        "description": "The ARIA label for close button of mobile sidebar"
+    },
+    "theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": {
+        "message": "← Перейти к главному меню",
+        "description": "The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)"
+    },
+    "theme.docs.sidebar.toggleSidebarButtonAriaLabel": {
+        "message": "Переключить навигационную панель",
+        "description": "The ARIA label for hamburger menu button of mobile navigation"
+    },
+    "theme.docs.sidebar.expandButtonTitle": {
+        "message": "Развернуть сайдбар",
+        "description": "The ARIA label and title attribute for expand button of doc sidebar"
+    },
+    "theme.docs.sidebar.expandButtonAriaLabel": {
+        "message": "Развернуть сайдбар",
+        "description": "The ARIA label and title attribute for expand button of doc sidebar"
+    },
+    "theme.ErrorPageContent.tryAgain": {
+        "message": "Попробуйте ещё раз",
+        "description": "The label of the button to try again rendering when the React error boundary captures an error"
+    },
+    "theme.common.skipToMainContent": {
+        "message": "Перейти к основному содержимому",
+        "description": "The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation"
+    },
+    "theme.tags.tagsPageTitle": {
+        "message": "Теги",
+        "description": "The title of the tag list page"
+    },
+    "theme.unlistedContent.title": {
+        "message": "Unlisted page",
+        "description": "The unlisted content banner title"
+    },
+    "theme.unlistedContent.message": {
+        "message": "This page is unlisted. Search engines will not index it, and only users having a direct link can access it.",
+        "description": "The unlisted content banner message"
+    },
+    "landing.getStartedButton": {
+        "message": "Приступим"
+    },
+    "footer.slogan": {
+        "message": "Фреймворк для end-to-end тестирования современных веб-приложений в любых масштабах и окружениях."
+    },
+    "footer.contact-us": {
+        "message": "Связаться с нами"
+    },
+    "landing.installation-prompt.heading": {
+        "message": "Попробуйте {testplane} уже сейчас"
+    },
+    "landing.installation-prompt.description": {
+        "message": "Загляните в {docsLink} и запустите ваш первый тест на Testplane."
+    },
+    "landing.installation-prompt.description.docs-link": {
+        "message": "документацию"
+    },
+    "landing.landing-head.heading": {
+        "message": "{testplane} универсальное решение для e2e тестирования веба"
+    },
+    "landing.landing-head.heading.highlight": {
+        "message": "ultimate"
+    },
+    "landing.landing-head.description": {
+        "message": "Testplane — проверенный годами фреймворк для работы с тестами в {anyScale}, {anyBrowser} и на {anyPlatform}."
+    },
+    "landing.landing-head.description.anyScale": {
+        "message": "любых объемах"
+    },
+    "landing.landing-head.description.anyBrowser": {
+        "message": "любых браузерах"
+    },
+    "landing.landing-head.description.anyPlatform": {
+        "message": "любых платформах"
+    },
+    "landing.landing-head.badge.leftTitle": {
+        "message": "Testplane в open source!"
+    },
+    "landing.landing-head.badge.rightTitle": {
+        "message": "Поставьте звёздочку"
+    },
+    "landing.animated-demo.heading.familiar-api": {
+        "message": "Знакомое и удобное API, которое работает везде"
+    },
+    "landing.animated-demo.heading.instant-feedback": {
+        "message": "Мгновенная обратная связь по мере написания теста"
+    },
+    "landing.animated-demo.heading.html-report": {
+        "message": "Просмотр результатов прогона в HTML отчете"
+    },
+    "landing.animated-demo.heading.gui": {
+        "message": "Простой и мощный режим GUI"
+    },
+    "landing.animated-demo.heading.visual-testing": {
+        "message": "Широкие возможности по визуальным проверкам"
+    },
+    "landing.animated-demo.stats.tests": {
+        "message": "Запусков тестов"
+    },
+    "landing.animated-demo.stats.stars": {
+        "message": "Звёзд на GitHub"
+    },
+    "landing.animated-demo.stats.projects": {
+        "message": "Проектов на Testplane"
+    },
+    "landing.core-features.heading": {
+        "message": "Почти {highlight} возможности"
+    },
+    "landing.core-features.heading.highlight": {
+        "message": "безграничные"
+    },
+    "landing.additional-features.heading": {
+        "message": "Фреймворк, где {highlight}"
+    },
+    "landing.additional-features.heading.highlight": {
+        "message": "всё включено"
+    },
+    "landing.core-features.browsers.heading": {
+        "message": "Запускайте тесты в любом {underline}"
+    },
+    "landing.core-features.browsers.heading.underline": {
+        "message": "браузере"
+    },
+    "landing.core-features.scale.heading": {
+        "message": "Тестируйте в любых {underline}"
+    },
+    "landing.core-features.browsers.scale.underline": {
+        "message": "масштабах"
+    },
+    "landing.core-features.extend.heading": {
+        "message": "Кастомизируйте и {underline} функционал"
+    },
+    "landing.core-features.browsers.extend.underline": {
+        "message": "расширяйте"
+    },
+    "landing.additional-features.visual.heading": {
+        "message": "Визуальные проверки"
+    },
+    "landing.additional-features.tooling.heading": {
+        "message": "Продвинутый тулинг"
+    },
+    "landing.additional-features.repl.heading": {
+        "message": "Работа с тестами в live"
+    },
+    "landing.additional-features.flaky.heading": {
+        "message": "Подавление флапов"
+    },
+    "landing.additional-features.community.heading": {
+        "message": "Растущее сообщество"
+    },
+    "landing.additional-features.scale.heading": {
+        "message": "Масштабируемость"
+    },
+    "landing.core-features.browsers.descr": {
+        "message": "Выполняйте тесты в окружении ваших пользователей — не только в последних билдах Chrome."
+    },
+    "landing.core-features.scale.descr": {
+        "message": "Сколько бы тестов у вас ни было — testplane отлично с ними справится."
+    },
+    "landing.core-features.extend.descr": {
+        "message": "Благодаря многим точкам расширения testplane можно адаптировать даже к самым специфичным требованиям."
+    },
+    "landing.core-features.browsers.modern": {
+        "message": "Все современные браузеры"
+    },
+    "landing.core-features.browsers.devices": {
+        "message": "Android/iOS устройства"
+    },
+    "landing.core-features.browsers.appium": {
+        "message": "Смарт ТВ и IoT устройства через Appium"
+    },
+    "landing.core-features.browsers.protocols": {
+        "message": "Все современные протоколы"
+    },
+    "landing.core-features.browsers.version": {
+        "message": "Независимость от версий браузеров"
+    },
+    "landing.core-features.browsers.ancient": {
+        "message": "Древние браузеры, как Internet Explorer"
+    },
+    "landing.core-features.scale.grid": {
+        "message": "Удаленный грид (BrowserStack и др.)"
+    },
+    "landing.core-features.scale.local": {
+        "message": "Быстрый локальный запуск"
+    },
+    "landing.core-features.scale.sharding": {
+        "message": "Шардирование"
+    },
+    "landing.core-features.scale.parallel": {
+        "message": "Параллельное выполнение"
+    },
+    "landing.core-features.scale.isolation": {
+        "message": "Изоляция тестов"
+    },
+    "landing.core-features.extend.plugin-system": {
+        "message": "Система плагинов"
+    },
+    "landing.core-features.extend.plugin-opensource": {
+        "message": "Десятки плагинов в open source"
+    },
+    "landing.core-features.extend.reporters": {
+        "message": "Кастомные отчеты"
+    },
+    "landing.core-features.extend.execution": {
+        "message": "Кастомная логика выполнения"
+    },
+    "landing.core-features.extend.commands": {
+        "message": "Кастомные команды"
+    },
+    "landing.additional-features.visual.assertions": {
+        "message": "Скриншотные проверки"
+    },
+    "landing.additional-features.visual.ui": {
+        "message": "UI для работы со скриншотами"
+    },
+    "landing.additional-features.visual.diff-modes": {
+        "message": "7+ режимов просмотра диффов"
+    },
+    "landing.additional-features.visual.any-area": {
+        "message": "Отдельные элементы или вся страница"
+    },
+    "landing.additional-features.tooling.html-reporter": {
+        "message": "Html-reporter с множеством фич"
+    },
+    "landing.additional-features.tooling.gui": {
+        "message": "Удобный GUI режим"
+    },
+    "landing.additional-features.tooling.profiler": {
+        "message": "Профайлер тестов и плагинов"
+    },
+    "landing.additional-features.repl.feedback": {
+        "message": "Мгновенный фидбек"
+    },
+    "landing.additional-features.repl.step": {
+        "message": "Отладка каждого шага теста"
+    },
+    "landing.additional-features.repl.any-env": {
+        "message": "Работает и локально, и с удаленным гридом"
+    },
+    "landing.additional-features.flaky.auto-wait": {
+        "message": "Авто-ожидание"
+    },
+    "landing.additional-features.flaky.isolation": {
+        "message": "Изоляция на уровне браузерных контекстов"
+    },
+    "landing.additional-features.flaky.retries": {
+        "message": "Умные ретраи"
+    },
+    "landing.additional-features.flaky.animations": {
+        "message": "Автоматическое отключение анимаций"
+    },
+    "landing.additional-features.community.free": {
+        "message": "Открытый и бесплатный для всех"
+    },
+    "landing.additional-features.community.issues": {
+        "message": "Сотни разобранных обращений на GitHub"
+    },
+    "landing.additional-features.community.docs": {
+        "message": "Подробные документация и гайды"
+    },
+    "landing.additional-features.community.maintainers": {
+        "message": "Активная команда мэйнтейнеров"
+    },
+    "landing.additional-features.scale.battle-tested": {
+        "message": "Проверенный на десятках тысяч тестов"
+    },
+    "landing.additional-features.scale.ci-or-local": {
+        "message": "Работает одинаково хорошо локально и в CI"
+    },
+    "landing.additional-features.scale.independent": {
+        "message": "Нет привязки к браузерам, платформе или CI"
+    },
+    "landing.core-features.browsers.versions": {
+        "message": "Нет привязки к версиям браузеров"
+    }
+}
diff --git a/i18n/ru/docusaurus-plugin-content-blog/options.json b/i18n/ru/docusaurus-plugin-content-blog/options.json
new file mode 100644
index 0000000..159eb3b
--- /dev/null
+++ b/i18n/ru/docusaurus-plugin-content-blog/options.json
@@ -0,0 +1,14 @@
+{
+    "title": {
+        "message": "Blog",
+        "description": "The title for the blog used in SEO"
+    },
+    "description": {
+        "message": "Blog",
+        "description": "The description for the blog used in SEO"
+    },
+    "sidebar.title": {
+        "message": "Recent posts",
+        "description": "The label for the left sidebar"
+    }
+}
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current.json b/i18n/ru/docusaurus-plugin-content-docs/current.json
new file mode 100644
index 0000000..5e6fe8a
--- /dev/null
+++ b/i18n/ru/docusaurus-plugin-content-docs/current.json
@@ -0,0 +1,54 @@
+{
+    "version.label": {
+        "message": "v8",
+        "description": "The label for version current"
+    },
+    "sidebar.mainSidebar.category.Config": {
+        "message": "Конфиг testplane",
+        "description": "The label for category Config in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.HTML Reporter": {
+        "message": "HTML Отчет",
+        "description": "The label for category HTML Reporter in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.Plugins": {
+        "message": "Плагины",
+        "description": "The label for category Plugins in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.Commands": {
+        "message": "Команды в тестах",
+        "description": "The label for category Commands in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.browser": {
+        "message": "browser",
+        "description": "The label for category browser in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.element": {
+        "message": "element",
+        "description": "The label for category element in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.expect": {
+        "message": "expect",
+        "description": "The label for category expect in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.mock": {
+        "message": "mock",
+        "description": "The label for category mock in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.Guides": {
+        "message": "Рецепты",
+        "description": "The label for category Guides in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.Migrations": {
+        "message": "Руководства по миграции",
+        "description": "The label for category Migrations in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.category.Reference": {
+        "message": "Справочник",
+        "description": "The label for category Reference in sidebar mainSidebar"
+    },
+    "sidebar.mainSidebar.doc.Quickstart": {
+        "message": "Быстрый старт",
+        "description": "The label for the doc item Quickstart in sidebar mainSidebar, linking to the doc quickstart/index"
+    }
+}
diff --git a/i18n/ru/docusaurus-theme-classic/footer.json b/i18n/ru/docusaurus-theme-classic/footer.json
new file mode 100644
index 0000000..3af6625
--- /dev/null
+++ b/i18n/ru/docusaurus-theme-classic/footer.json
@@ -0,0 +1,70 @@
+{
+    "link.title.Quickstart": {
+        "message": "Быстрый старт",
+        "description": "The title of the footer links column with title=Quickstart in the footer"
+    },
+    "link.title.Core concepts": {
+        "message": "Ключевые функции",
+        "description": "The title of the footer links column with title=Core concepts in the footer"
+    },
+    "link.title.Customization": {
+        "message": "Кастомизация",
+        "description": "The title of the footer links column with title=Customization in the footer"
+    },
+    "link.title.Resources": {
+        "message": "Ресурсы",
+        "description": "The title of the footer links column with title=Resources in the footer"
+    },
+    "link.item.label.Installation": {
+        "message": "Установка",
+        "description": "The label of footer link with label=Installation linking to /docs/v8/quickstart"
+    },
+    "link.item.label.Why testplane?": {
+        "message": "Почему testplane?",
+        "description": "The label of footer link with label=Why testplane? linking to /docs/v8#why-testplane"
+    },
+    "link.item.label.Browser commands": {
+        "message": "Команды браузера",
+        "description": "The label of footer link with label=Browser commands linking to /docs/v8/commands/overview"
+    },
+    "link.item.label.Testplane config": {
+        "message": "Конфиг Testplane",
+        "description": "The label of footer link with label=Testplane config linking to /docs/v8/config/main"
+    },
+    "link.item.label.Testplane UI": {
+        "message": "Testplane UI",
+        "description": "The label of footer link with label=Testplane UI linking to /docs/v8/html-reporter/html-reporter-setup"
+    },
+    "link.item.label.Docs": {
+        "message": "Документация",
+        "description": "The label of footer link with label=Docs linking to /docs/v8"
+    },
+    "link.item.label.Blog": {
+        "message": "Блог",
+        "description": "The label of footer link with label=Blog linking to /blog"
+    },
+    "link.item.label.Changelog": {
+        "message": "Changelog",
+        "description": "The label of footer link with label=Changelog linking to https://github.com/gemini-testing/testplane/blob/master/CHANGELOG.md"
+    },
+    "copyright": {
+        "message": "MIT License © 2024",
+        "description": "The footer copyright"
+    },
+    "link.item.label.Overview": {
+        "message": "Обзор",
+        "description": "The label of footer link with label=Overview linking to /docs/v8"
+    },
+    "link.item.label.Testplane API": {
+        "message": "Testplane API",
+        "description": "The label of footer link with label=Testplane API linking to /docs/v8/reference/hermione-api"
+    },
+    "link.item.label.Testplane events": {
+        "message": "События Testplane",
+        "description": "The label of footer link with label=Testplane events linking to /docs/v8/reference/testplane-events"
+    },
+    "link.item.label.Plugins": {
+        "message": "Плагины",
+        "description": "The label of footer link with label=Plugins linking to /docs/v8/guides/how-to-write-your-own-plugin"
+    }
+}
diff --git a/i18n/ru/docusaurus-theme-classic/navbar.json b/i18n/ru/docusaurus-theme-classic/navbar.json
new file mode 100644
index 0000000..713f5c4
--- /dev/null
+++ b/i18n/ru/docusaurus-theme-classic/navbar.json
@@ -0,0 +1,18 @@
+{
+    "title": {
+        "message": "testplane",
+        "description": "The title in the navbar"
+    },
+    "item.label.Docs": {
+        "message": "Документация",
+        "description": "Navbar item with label Docs"
+    },
+    "item.label.Blog": {
+        "message": "Блог",
+        "description": "Navbar item with label Blog"
+    },
+    "item.label.GitHub": {
+        "message": "GitHub",
+        "description": "Navbar item with label GitHub"
+    }
+}
diff --git a/sidebars.ts b/sidebars.ts
index bd38bcc..541cb5d 100644
--- a/sidebars.ts
+++ b/sidebars.ts
@@ -1,7 +1,52 @@
 import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
 
 const sidebars: SidebarsConfig = {
-    mainSidebar: [{ type: "autogenerated", dirName: "." }],
+    mainSidebar: [
+        "index",
+        {
+            type: "doc",
+            id: "quickstart/index",
+            label: "Quickstart",
+        },
+        {
+            type: "category",
+            label: "Commands",
+            items: [{ type: "autogenerated", dirName: "commands" }],
+            link: { type: "doc", id: "commands/overview" },
+        },
+        {
+            type: "category",
+            label: "Config",
+            items: [{ type: "autogenerated", dirName: "config" }],
+            link: { type: "doc", id: "config/main" },
+        },
+        {
+            type: "category",
+            label: "Guides",
+            items: [{ type: "autogenerated", dirName: "guides" }],
+        },
+        {
+            type: "category",
+            label: "HTML Reporter",
+            items: [{ type: "autogenerated", dirName: "html-reporter" }],
+            link: { type: "doc", id: "html-reporter/html-reporter-setup" },
+        },
+        {
+            type: "category",
+            label: "Migrations",
+            items: [{ type: "autogenerated", dirName: "migrations" }],
+        },
+        {
+            type: "category",
+            label: "Plugins",
+            items: [{ type: "autogenerated", dirName: "plugins" }],
+        },
+        {
+            type: "category",
+            label: "Reference",
+            items: [{ type: "autogenerated", dirName: "reference" }],
+        },
+    ],
 };
 
 export default sidebars;
diff --git a/src/components/FeatureBlock/index.tsx b/src/components/FeatureBlock/index.tsx
index 5a64e44..b92d1bd 100644
--- a/src/components/FeatureBlock/index.tsx
+++ b/src/components/FeatureBlock/index.tsx
@@ -33,9 +33,9 @@ export function FeatureBlock(props: FeatureBlockProps) {
                     {props.items.map((item, index) => (
                         <div
                             key={index}
-                            className="mb-3 flex max-w-48 items-center text-lg font-medium text-gray-500"
+                            className="mb-3 flex max-w-48 text-lg font-medium text-gray-500"
                         >
-                            <TickIcon className="mr-1 size-5 flex-shrink-0 fill-gray-500" />
+                            <TickIcon className="mr-1 mt-1 size-5 flex-shrink-0 fill-gray-500" />
                             {item}
                         </div>
                     ))}
diff --git a/src/components/FeaturesDemo/index.tsx b/src/components/FeaturesDemo/index.tsx
index 2d837d3..df7cb0f 100644
--- a/src/components/FeaturesDemo/index.tsx
+++ b/src/components/FeaturesDemo/index.tsx
@@ -55,7 +55,10 @@ import {
     useScreenOrientation,
 } from "@site/src/components/FeaturesDemo/utils";
 
-export function FeaturesDemo(props: { className?: string }) {
+export function FeaturesDemo(props: {
+    className?: string;
+    headings?: { id: HeadingId; data: string }[];
+}) {
     const store = useStore();
     const heading = useStore(state => state.heading);
 
@@ -69,6 +72,7 @@ export function FeaturesDemo(props: { className?: string }) {
     }));
     const codeElementRef = useRef<HTMLDivElement>(null);
     const codeCleanupRef = useRef<() => void>(null);
+    const headings = props.headings ?? HEADINGS;
 
     const codeElement = (
         <div
@@ -108,7 +112,7 @@ export function FeaturesDemo(props: { className?: string }) {
 
     const steps: (() => void | Promise<void>)[] = [
         async function openCodeEditor() {
-            store.setHeading(getById(HEADINGS, HeadingId.FamiliarApi).data, signal);
+            store.setHeading(getById(headings, HeadingId.FamiliarApi).data, signal);
 
             if (useStore.getState().windows.length > 0) {
                 store.popWindow(signal);
@@ -136,7 +140,7 @@ export function FeaturesDemo(props: { className?: string }) {
             await pause(PAUSE_LG, signal);
         },
         async function typeLiveTestDeclaration() {
-            store.setHeading(getById(HEADINGS, HeadingId.ReplMode).data, signal);
+            store.setHeading(getById(headings, HeadingId.ReplMode).data, signal);
 
             await typeCode(getById(codeRefs, CodeId.ReplTestBegin), codeCleanupRef);
             await typeCode(getById(codeRefs, CodeId.ReplTestEnd), codeCleanupRef);
@@ -345,7 +349,7 @@ export function FeaturesDemo(props: { className?: string }) {
 
             await pause(PAUSE_SM, signal);
 
-            store.setHeading(getById(HEADINGS, HeadingId.HtmlReport).data, signal);
+            store.setHeading(getById(headings, HeadingId.HtmlReport).data, signal);
 
             store.popWindow(signal);
 
@@ -370,7 +374,7 @@ export function FeaturesDemo(props: { className?: string }) {
             await pause(PAUSE_LG, signal);
         },
         async function selectTestToRun() {
-            store.setHeading(getById(HEADINGS, HeadingId.GuiMode).data, signal);
+            store.setHeading(getById(headings, HeadingId.GuiMode).data, signal);
             await pause(1000, signal);
 
             // eslint-disable-next-line @typescript-eslint/non-nullable-type-assertion-style
@@ -495,7 +499,7 @@ export function FeaturesDemo(props: { className?: string }) {
             store.popWindow(signal);
         },
         function displayTestResults() {
-            store.setHeading(getById(HEADINGS, HeadingId.GuiMode).data, signal);
+            store.setHeading(getById(headings, HeadingId.GuiMode).data, signal);
 
             const newTests = _.cloneDeep(
                 (
diff --git a/src/components/LinkBadge/index.tsx b/src/components/LinkBadge/index.tsx
index 502551f..2ef0062 100644
--- a/src/components/LinkBadge/index.tsx
+++ b/src/components/LinkBadge/index.tsx
@@ -2,12 +2,18 @@ import clsx from "clsx";
 import styles from "./index.module.scss";
 import mainStyles from "@site/src/pages/index.module.scss";
 import AngleIcon from "@site/static/icons/angle.svg";
-import React from "react";
+import React, { ReactNode } from "react";
 
-export function LinkBadge() {
+interface LinkBadgeProps {
+    link: string;
+    leftTitle: ReactNode;
+    rightTitle: ReactNode;
+}
+
+export function LinkBadge(props: LinkBadgeProps) {
     return (
         <a
-            href="https://github.com/gemini-testing/testplane/"
+            href={props.link}
             target="_blank"
             className={clsx(
                 mainStyles["box-glow"],
@@ -17,9 +23,9 @@ export function LinkBadge() {
             rel="noreferrer"
         >
             <div className="mr-2 rounded-full bg-gradient-to-br from-violet-500 to-rose-400 px-3 py-0.5 text-white">
-                Testplane is open source!
+                {props.leftTitle}
             </div>
-            <span className="flex-shrink overflow-hidden text-ellipsis">Star on github</span>
+            <span className="flex-shrink overflow-hidden text-ellipsis">{props.rightTitle}</span>
             <AngleIcon className="ml-1 size-3 flex-shrink-0" />
         </a>
     );
diff --git a/src/components/pages/LandingPage/sections/additional-features.tsx b/src/components/pages/LandingPage/sections/additional-features.tsx
index fa26212..6ff342c 100644
--- a/src/components/pages/LandingPage/sections/additional-features.tsx
+++ b/src/components/pages/LandingPage/sections/additional-features.tsx
@@ -13,61 +13,147 @@ import WarningIcon from "@site/static/icons/warning.svg";
 import CommunityIcon from "@site/static/icons/community.svg";
 import ChartIcon from "@site/static/icons/chart.svg";
 import clsx from "clsx";
+import Translate, { translate } from "@docusaurus/Translate";
 
 export const AdditionalFeaturesSection = () => {
     const FEATURE_CARDS: FeatureCardProps[] = [
         {
-            heading: "Vast visual testing capabilities",
+            heading: translate({
+                id: "landing.additional-features.visual.heading",
+                message: "Vast visual testing capabilities",
+            }),
             icon: <EyeIcon className="size-5" />,
             items: [
-                "Visual assertions",
-                "UI for saving and updating screenshots",
-                "Multiple diff modes",
-                "Capture certain elements or the whole page",
+                translate({
+                    id: "landing.additional-features.visual.assertions",
+                    message: "Visual assertions",
+                }),
+                translate({
+                    id: "landing.additional-features.visual.ui",
+                    message: "UI for saving and updating screenshots",
+                }),
+                translate({
+                    id: "landing.additional-features.visual.diff-modes",
+                    message: "Multiple diff modes",
+                }),
+                translate({
+                    id: "landing.additional-features.visual.any-area",
+                    message: "Capture certain elements or the whole page",
+                }),
             ],
         },
         {
-            heading: "Feature-rich tooling",
+            heading: translate({
+                id: "landing.additional-features.tooling.heading",
+                message: "Feature-rich tooling",
+            }),
             icon: <ToolsIcon className="size-5" />,
-            items: ["Powerful html-reporter", "Responsive GUI mode", "Tests and plugin profiler"],
+            items: [
+                translate({
+                    id: "landing.additional-features.tooling.html-reporter",
+                    message: "Powerful html-reporter",
+                }),
+                translate({
+                    id: "landing.additional-features.tooling.gui",
+                    message: "Responsive GUI mode",
+                }),
+                translate({
+                    id: "landing.additional-features.tooling.profiler",
+                    message: "Tests and plugin profiler",
+                }),
+            ],
         },
         {
-            heading: "Live tests editing",
+            heading: translate({
+                id: "landing.additional-features.repl.heading",
+                message: "Live tests editing",
+            }),
             icon: <SpeedIcon className="size-5" />,
             items: [
-                "Get immediate feedback as you type",
-                "Clearly see each step",
-                "Works both with local browser and remote grid",
+                translate({
+                    id: "landing.additional-features.repl.feedback",
+                    message: "Get immediate feedback as you type",
+                }),
+                translate({
+                    id: "landing.additional-features.repl.step",
+                    message: "Clearly see each step",
+                }),
+                translate({
+                    id: "landing.additional-features.repl.any-env",
+                    message: "Works both with local browser and remote grid",
+                }),
             ],
         },
         {
-            heading: "Tackle flaky tests",
+            heading: translate({
+                id: "landing.additional-features.flaky.heading",
+                message: "Tackle flaky tests",
+            }),
             icon: <WarningIcon className="size-5" />,
             items: [
-                "Auto-wait",
-                "Isolation via browser contexts",
-                "Smart retries",
-                "Automatic animations handling",
+                translate({
+                    id: "landing.additional-features.flaky.auto-wait",
+                    message: "Auto-wait",
+                }),
+                translate({
+                    id: "landing.additional-features.flaky.isolation",
+                    message: "Isolation via browser contexts",
+                }),
+                translate({
+                    id: "landing.additional-features.flaky.retries",
+                    message: "Smart retries",
+                }),
+                translate({
+                    id: "landing.additional-features.flaky.animations",
+                    message: "Automatic animations handling",
+                }),
             ],
         },
         {
-            heading: "Growing community",
+            heading: translate({
+                id: "landing.additional-features.community.heading",
+                message: "Growing community",
+            }),
             icon: <CommunityIcon className="size-6" />,
             items: [
-                "Open source and free to use for everyone",
-                "Hundreds of closed issues on GitHub",
-                "Extensive guides and docs",
-                "Active team of maintainers",
+                translate({
+                    id: "landing.additional-features.community.free",
+                    message: "Open source and free to use for everyone",
+                }),
+                translate({
+                    id: "landing.additional-features.community.issues",
+                    message: "Hundreds of closed issues on GitHub",
+                }),
+                translate({
+                    id: "landing.additional-features.community.docs",
+                    message: "Extensive guides and docs",
+                }),
+                translate({
+                    id: "landing.additional-features.community.maintainers",
+                    message: "Active team of maintainers",
+                }),
             ],
             className: "hidden sm:block",
         },
         {
-            heading: "Designed to work at any scale",
+            heading: translate({
+                id: "landing.additional-features.scale.heading",
+                message: "Designed to work at any scale",
+            }),
             icon: <ChartIcon className="size-5" />,
             items: [
-                "Battle-tested on projects with tens of thousands of tests",
-                "Created with both local development and CI systems in mind",
-                "Independent of browser, platform, CI system",
+                translate({
+                    id: "landing.additional-features.scale.battle-tested",
+                    message: "Battle-tested on projects with tens of thousands of tests",
+                }),
+                translate({
+                    id: "landing.additional-features.scale.ci-or-local",
+                    message: "Created with both local development and CI systems in mind",
+                }),
+                translate({
+                    id: "landing.additional-features.scale.independent",
+                    message: "Independent of browser, platform, CI system",
+                }),
             ],
             className: "hidden sm:block",
         },
@@ -81,15 +167,24 @@ export const AdditionalFeaturesSection = () => {
                 <Star5 className={"absolute left-[6%] top-[70%] scale-x-[-0.7] scale-y-[0.7]"} />
                 <Star4Violet className={"absolute left-[85%] top-[10%] size-24 rotate-[15deg]"} />
             </div>
-            <div className="container max-w-screen-lg pt-10">
+            <div className="container !max-w-screen-lg pt-10">
                 <AnimatedAppear>
                     <Heading>
                         <div className="mb-3 text-gray-700">
-                            Your{" "}
-                            <span className="mt-3 bg-gradient-to-r from-sky-600 to-fuchsia-500 bg-clip-text text-transparent">
-                                all-in-one
-                            </span>{" "}
-                            testing framework
+                            <Translate
+                                id="landing.additional-features.heading"
+                                values={{
+                                    highlight: (
+                                        <span className="mt-3 bg-gradient-to-r from-sky-600 to-fuchsia-500 bg-clip-text text-transparent">
+                                            <Translate id="landing.additional-features.heading.highlight">
+                                                all-in-one
+                                            </Translate>
+                                        </span>
+                                    ),
+                                }}
+                            >
+                                {"Your {highlight} testing framework"}
+                            </Translate>
                         </div>
                     </Heading>
                 </AnimatedAppear>
@@ -102,7 +197,7 @@ export const AdditionalFeaturesSection = () => {
                             )}
                             key={index}
                         >
-                            <FeatureCard {...props} />
+                            <FeatureCard {...props} key={index} />
                         </AnimatedAppear>
                     ))}
                 </div>
diff --git a/src/components/pages/LandingPage/sections/animated-demo.tsx b/src/components/pages/LandingPage/sections/animated-demo.tsx
index 1d97bf0..ec80501 100644
--- a/src/components/pages/LandingPage/sections/animated-demo.tsx
+++ b/src/components/pages/LandingPage/sections/animated-demo.tsx
@@ -8,9 +8,48 @@ import { DemoStats } from "@site/src/components/DemoStats";
 import React from "react";
 import useBaseUrl from "@docusaurus/core/lib/client/exports/useBaseUrl";
 import BrowserOnly from "@docusaurus/core/lib/client/exports/BrowserOnly";
+import { HeadingId } from "@site/src/components/FeaturesDemo/constants";
+import { translate } from "@docusaurus/Translate";
 
 export const AnimatedDemoSection = () => {
     const grainyBg = `linear-gradient(41deg, rgb(227 119 252) 0%, rgb(142 78 253) 100%), url(${useBaseUrl("/img/landing/noise.png")})`;
+    const headings = [
+        {
+            id: HeadingId.FamiliarApi,
+            data: translate({
+                id: "landing.animated-demo.heading.familiar-api",
+                message: "Familiar and concise API, that works everywhere",
+            }),
+        },
+        {
+            id: HeadingId.ReplMode,
+            data: translate({
+                id: "landing.animated-demo.heading.instant-feedback",
+                message: "Get instant feedback as you write tests",
+            }),
+        },
+        {
+            id: HeadingId.HtmlReport,
+            data: translate({
+                id: "landing.animated-demo.heading.html-report",
+                message: "View data results in feature-rich report",
+            }),
+        },
+        {
+            id: HeadingId.GuiMode,
+            data: translate({
+                id: "landing.animated-demo.heading.gui",
+                message: "Powerful, yet easy to use GUI mode",
+            }),
+        },
+        {
+            id: HeadingId.VisualTesting,
+            data: translate({
+                id: "landing.animated-demo.heading.visual-testing",
+                message: "Vast visual testing capabilities",
+            }),
+        },
+    ];
 
     return (
         <section className={clsx(styles.demo, "relative")} style={{ backgroundImage: grainyBg }}>
@@ -21,12 +60,30 @@ export const AnimatedDemoSection = () => {
             </div>
             <div className="container mx-auto py-6">
                 <BrowserOnly>
-                    {() => <FeaturesDemo className="h-[75vh] 2xl:h-[800px]" />}
+                    {() => <FeaturesDemo className="h-[75vh] 2xl:h-[800px]" headings={headings} />}
                 </BrowserOnly>
                 <div className="flex justify-around pt-6">
-                    <DemoStats value="5.6B" description="Tests launched" />
-                    <DemoStats value="600+" description="Stars on GitHub" />
-                    <DemoStats value="300+" description="Projects that trust us" />
+                    <DemoStats
+                        value="5.6B"
+                        description={translate({
+                            id: "landing.animated-demo.stats.tests",
+                            message: "Tests launched",
+                        })}
+                    />
+                    <DemoStats
+                        value="600+"
+                        description={translate({
+                            id: "landing.animated-demo.stats.stars",
+                            message: "Stars on GitHub",
+                        })}
+                    />
+                    <DemoStats
+                        value="300+"
+                        description={translate({
+                            id: "landing.animated-demo.stats.projects",
+                            message: "Projects that trust us",
+                        })}
+                    />
                 </div>
             </div>
         </section>
diff --git a/src/components/pages/LandingPage/sections/core-features.tsx b/src/components/pages/LandingPage/sections/core-features.tsx
index 9775933..55064cb 100644
--- a/src/components/pages/LandingPage/sections/core-features.tsx
+++ b/src/components/pages/LandingPage/sections/core-features.tsx
@@ -4,19 +4,29 @@ import { FeatureBlock, FeatureBlockLayout } from "@site/src/components/FeatureBl
 import { GradientUnderline } from "@site/src/components/GradientUnderline";
 import useBaseUrl from "@docusaurus/core/lib/client/exports/useBaseUrl";
 import React from "react";
+import Translate, { translate } from "@docusaurus/Translate";
 
 export const CoreFeaturesSection = () => {
     return (
         <section className="bg-gray-100">
-            <div className="container max-w-screen-lg py-6">
+            <div className="container !max-w-screen-lg py-6">
                 <AnimatedAppear>
                     <Heading>
                         <div className="mb-3 text-gray-700">
-                            Accelerate{" "}
-                            <span className="bg-gradient-to-r from-sky-600 to-fuchsia-500 bg-clip-text text-transparent">
-                                everything
-                            </span>{" "}
-                            with testplane
+                            <Translate
+                                id="landing.core-features.heading"
+                                values={{
+                                    highlight: (
+                                        <span className="bg-gradient-to-r from-sky-600 to-fuchsia-500 bg-clip-text text-transparent">
+                                            <Translate id="landing.core-features.heading.highlight">
+                                                everything
+                                            </Translate>
+                                        </span>
+                                    ),
+                                }}
+                            >
+                                {"Accelerate {highlight} with testplane"}
+                            </Translate>
                         </div>
                     </Heading>
                 </AnimatedAppear>
@@ -24,20 +34,52 @@ export const CoreFeaturesSection = () => {
                     <FeatureBlock
                         heading={
                             <span>
-                                Run your tests in any{" "}
-                                <GradientUnderline className=" rotate-[2deg]">
-                                    browser
-                                </GradientUnderline>
+                                <Translate
+                                    id="landing.core-features.browsers.heading"
+                                    values={{
+                                        underline: (
+                                            <GradientUnderline className=" rotate-[2deg]">
+                                                <Translate id="landing.core-features.browsers.heading.underline">
+                                                    browser
+                                                </Translate>
+                                            </GradientUnderline>
+                                        ),
+                                    }}
+                                >
+                                    {"Run your tests in any {underline}"}
+                                </Translate>
                             </span>
                         }
-                        description="Test in environment your users have, not just in the latest Chrome builds."
+                        description={translate({
+                            id: "landing.core-features.browsers.descr",
+                            message:
+                                "Test in environment your users have, not just in the latest Chrome builds.",
+                        })}
                         items={[
-                            "All modern browsers",
-                            "Real Android/iOS devices",
-                            "Smart TVs or IoT devices via Appium",
-                            "All modern protocols",
-                            "Independent of browser versions",
-                            "Ancient browsers, like Internet Explorer",
+                            translate({
+                                id: "landing.core-features.browsers.modern",
+                                message: "All modern browsers",
+                            }),
+                            translate({
+                                id: "landing.core-features.browsers.devices",
+                                message: "Real Android/iOS devices",
+                            }),
+                            translate({
+                                id: "landing.core-features.browsers.appium",
+                                message: "Smart TVs or IoT devices via Appium",
+                            }),
+                            translate({
+                                id: "landing.core-features.browsers.protocols",
+                                message: "All modern protocols",
+                            }),
+                            translate({
+                                id: "landing.core-features.browsers.versions",
+                                message: "Independent of browser versions",
+                            }),
+                            translate({
+                                id: "landing.core-features.browsers.ancient",
+                                message: "Ancient browsers, like Internet Explorer",
+                            }),
                         ]}
                         layout={FeatureBlockLayout.PictureOnTheRight}
                         imgSrc={useBaseUrl("/img/landing/browsers.svg")}
@@ -48,19 +90,48 @@ export const CoreFeaturesSection = () => {
                     <FeatureBlock
                         heading={
                             <span>
-                                Run your tests reliably at any{" "}
-                                <GradientUnderline className=" rotate-[-2deg]">
-                                    scale
-                                </GradientUnderline>
+                                <Translate
+                                    id="landing.core-features.scale.heading"
+                                    values={{
+                                        underline: (
+                                            <GradientUnderline className=" rotate-[2deg]">
+                                                <Translate id="landing.core-features.browsers.scale.underline">
+                                                    scale
+                                                </Translate>
+                                            </GradientUnderline>
+                                        ),
+                                    }}
+                                >
+                                    {"Run your tests reliably at any {underline}"}
+                                </Translate>
                             </span>
                         }
-                        description="Regardless of how many tests you have, testplane is a perfect fit."
+                        description={translate({
+                            id: "landing.core-features.scale.descr",
+                            message:
+                                "Regardless of how many tests you have, testplane is a perfect fit.",
+                        })}
                         items={[
-                            "Remote browser grid (e.g. BrowserStack)",
-                            "Blazing-fast local execution",
-                            "Sharding",
-                            "Parallel execution",
-                            "Test isolation",
+                            translate({
+                                id: "landing.core-features.scale.grid",
+                                message: "Remote browser grid (e.g. BrowserStack)",
+                            }),
+                            translate({
+                                id: "landing.core-features.scale.local",
+                                message: "Blazing-fast local execution",
+                            }),
+                            translate({
+                                id: "landing.core-features.scale.sharding",
+                                message: "Sharding",
+                            }),
+                            translate({
+                                id: "landing.core-features.scale.parallel",
+                                message: "Parallel execution",
+                            }),
+                            translate({
+                                id: "landing.core-features.scale.isolation",
+                                message: "Test isolation",
+                            }),
                         ]}
                         layout={FeatureBlockLayout.PictureOnTheLeft}
                         imgSrc={useBaseUrl("/img/landing/scale.svg")}
@@ -71,20 +142,48 @@ export const CoreFeaturesSection = () => {
                     <FeatureBlock
                         heading={
                             <span>
-                                Customise and{" "}
-                                <GradientUnderline className="rotate-[3deg]">
-                                    extend
-                                </GradientUnderline>{" "}
-                                the way you want
+                                <Translate
+                                    id="landing.core-features.extend.heading"
+                                    values={{
+                                        underline: (
+                                            <GradientUnderline className=" rotate-[2deg]">
+                                                <Translate id="landing.core-features.browsers.extend.underline">
+                                                    extend
+                                                </Translate>
+                                            </GradientUnderline>
+                                        ),
+                                    }}
+                                >
+                                    {"Customise and {underline} the way you want"}
+                                </Translate>
                             </span>
                         }
-                        description="Thanks to testplane’s multiple extenstion points, you may adapt the framework even to the most exotic needs."
+                        description={translate({
+                            id: "landing.core-features.extend.descr",
+                            message:
+                                "Thanks to testplane’s multiple extenstion points, you may adapt the framework even to the most exotic needs.",
+                        })}
                         items={[
-                            "Rich plugin system",
-                            "Dozens of open source plugins",
-                            "Custom reporters",
-                            "Custom execution logic",
-                            "Custom commands",
+                            translate({
+                                id: "landing.core-features.extend.plugin-system",
+                                message: "Rich plugin system",
+                            }),
+                            translate({
+                                id: "landing.core-features.extend.plugin-opensource",
+                                message: "Dozens of open source plugins",
+                            }),
+                            translate({
+                                id: "landing.core-features.extend.reporters",
+                                message: "Custom reporters",
+                            }),
+                            translate({
+                                id: "landing.core-features.extend.execution",
+                                message: "Custom execution logic",
+                            }),
+                            translate({
+                                id: "landing.core-features.extend.commands",
+                                message: "Custom commands",
+                            }),
                         ]}
                         layout={FeatureBlockLayout.PictureOnTheRight}
                         imgSrc={useBaseUrl("/img/landing/extensibility.svg")}
diff --git a/src/components/pages/LandingPage/sections/installation-prompt.tsx b/src/components/pages/LandingPage/sections/installation-prompt.tsx
index 86957e0..219d959 100644
--- a/src/components/pages/LandingPage/sections/installation-prompt.tsx
+++ b/src/components/pages/LandingPage/sections/installation-prompt.tsx
@@ -3,6 +3,9 @@ import { Heading } from "@site/src/components/FeaturesDemo/AnimatedHeading";
 import React, { useRef } from "react";
 import Typed from "typed.js";
 import useBaseUrl from "@docusaurus/core/lib/client/exports/useBaseUrl";
+import Link from "@docusaurus/Link";
+import { useLatestVersion } from "@docusaurus/plugin-content-docs/client";
+import Translate from "@docusaurus/Translate";
 
 export const InstallationPromptSection = () => {
     const consoleRef = useRef(null);
@@ -14,10 +17,12 @@ export const InstallationPromptSection = () => {
             new Typed(consoleRef.current, {
                 typeSpeed: 50,
                 cursorChar: "▊",
-                strings: ["npm init testplane"],
+                strings: ["npm init testplane@latest"],
             });
         }
     };
+    const docsPluginId = undefined; // using default plugin
+    const latestVersion = useLatestVersion(docsPluginId);
 
     return (
         <section className="relative overflow-hidden bg-gray-50">
@@ -34,25 +39,40 @@ export const InstallationPromptSection = () => {
                 />
             </div>
             <AnimatedAppear onAppear={type}>
-                <div className="container max-w-screen-lg pb-16 pt-10">
+                <div className="container !max-w-screen-lg pb-16 pt-10">
                     <Heading>
                         <div className="mb-3 text-gray-700">
-                            Start using{" "}
-                            <span className="mt-3 bg-gradient-to-r from-sky-600 to-fuchsia-500 bg-clip-text text-transparent">
-                                testplane
-                            </span>{" "}
-                            in minutes
+                            <Translate
+                                id="landing.installation-prompt.heading"
+                                values={{
+                                    testplane: (
+                                        <span className="mt-3 bg-gradient-to-r from-sky-600 to-fuchsia-500 bg-clip-text text-transparent">
+                                            testplane
+                                        </span>
+                                    ),
+                                }}
+                            >
+                                {"Start using {testplane} in minutes"}
+                            </Translate>
                         </div>
                     </Heading>
                     <div className="text-center text-lg font-medium text-gray-500">
-                        Visit{" "}
-                        <a
-                            href="#"
-                            className="text-indigo-600 hover:text-indigo-400 hover:no-underline"
+                        <Translate
+                            id="landing.installation-prompt.description"
+                            values={{
+                                docsLink: (
+                                    <Link to={latestVersion.path}>
+                                        <Translate id="landing.installation-prompt.description.docs-link">
+                                            the docs
+                                        </Translate>
+                                    </Link>
+                                ),
+                            }}
                         >
-                            the docs
-                        </a>{" "}
-                        and tinker with your first testplane test after running CLI command below.
+                            {
+                                "Visit {docsLink} and tinker with your first testplane test after running CLI command below."
+                            }
+                        </Translate>
                     </div>
                     <div className="mx-12 mt-5 rounded-md bg-gradient-to-br from-indigo-500 to-fuchsia-500 p-0.5 sm:mx-24">
                         <div className="min-h-12 rounded-md bg-gray-800 p-3 font-mono text-gray-200">
diff --git a/src/components/pages/LandingPage/sections/landing-head.tsx b/src/components/pages/LandingPage/sections/landing-head.tsx
index 53803f3..bf28a66 100644
--- a/src/components/pages/LandingPage/sections/landing-head.tsx
+++ b/src/components/pages/LandingPage/sections/landing-head.tsx
@@ -9,8 +9,14 @@ import ArrowHandDrawn from "@site/static/img/landing/arrow.svg";
 import { AnimatedPlanet } from "@site/src/components/AnimatedPlanet";
 import React from "react";
 import { LinkBadge } from "@site/src/components/LinkBadge";
+import Translate from "@docusaurus/Translate";
+import Link from "@docusaurus/Link";
+import { useLatestVersion } from "@docusaurus/plugin-content-docs/client";
 
 export const LandingHeadSection = () => {
+    const docsPluginId = undefined; // using default plugin
+    const latestVersion = useLatestVersion(docsPluginId);
+
     return (
         <section className="overflow-hidden bg-gray-100">
             <MobileBg className="absolute top-0 w-full sm:hidden" />
@@ -24,28 +30,53 @@ export const LandingHeadSection = () => {
                 <Cone className={"absolute left-[68%] top-[50%] size-24 scale-75 sm:hidden"} />
                 <div className="mt-16 flex items-center py-8 sm:mt-0 2xl:py-16">
                     <div className="flex flex-grow basis-full flex-col items-start">
-                        <LinkBadge />
+                        <LinkBadge
+                            link="https://github.com/gemini-testing/testplane/"
+                            leftTitle={
+                                <Translate id="landing.landing-head.badge.leftTitle">
+                                    Testplane is open source!
+                                </Translate>
+                            }
+                            rightTitle={
+                                <Translate id="landing.landing-head.badge.rightTitle">
+                                    Star on github
+                                </Translate>
+                            }
+                        />
                         <h1
                             className={clsx(
                                 styles["text-glow"],
                                 "z-40 mt-2 text-5xl font-bold leading-[1.1] text-gray-700 md:leading-none 2xl:text-7xl",
                             )}
                         >
-                            <span
-                                className={clsx(
-                                    "bg-gradient-to-r from-sky-600 to-fuchsia-500 bg-clip-text text-transparent",
-                                    styles["no-text-glow"],
-                                )}
+                            <Translate
+                                id="landing.landing-head.heading"
+                                values={{
+                                    testplane: (
+                                        <span
+                                            className={clsx(
+                                                "bg-gradient-to-r from-sky-600 to-fuchsia-500 bg-clip-text text-transparent",
+                                                styles["no-text-glow"],
+                                            )}
+                                        >
+                                            testplane
+                                            <br />
+                                        </span>
+                                    ),
+                                    highlight: (
+                                        <span className="relative inline-block">
+                                            <HighlightRoundSvg className="absolute left-0 top-0 -translate-y-0.5 scale-[1.15]" />
+                                            <Translate id="landing.landing-head.heading.highlight">
+                                                ultimate
+                                            </Translate>
+                                        </span>
+                                    ),
+                                }}
                             >
-                                testplane
-                                <br />
-                            </span>
-                            is an{" "}
-                            <span className="relative inline-block">
-                                <HighlightRoundSvg className="absolute left-0 top-0 -translate-y-0.5 scale-[1.15]" />
-                                ultimate
-                            </span>{" "}
-                            solution for end-to-end testing workflows
+                                {
+                                    "{testplane} is an {highlight} solution for end-to-end testing workflows"
+                                }
+                            </Translate>
                         </h1>
                         <div
                             className={clsx(
@@ -53,13 +84,43 @@ export const LandingHeadSection = () => {
                                 "z-40 mt-5 text-lg text-gray-500 xl:text-xl",
                             )}
                         >
-                            Testplane is a battle-hardened framework for creating tests at{" "}
-                            <b>any scale</b>, <b>any browser</b> and <b>any platform</b>.
+                            <Translate
+                                id="landing.landing-head.description"
+                                values={{
+                                    anyScale: (
+                                        <b>
+                                            <Translate id="landing.landing-head.description.anyScale">
+                                                any scale
+                                            </Translate>
+                                        </b>
+                                    ),
+                                    anyBrowser: (
+                                        <b>
+                                            <Translate id="landing.landing-head.description.anyBrowser">
+                                                any browser
+                                            </Translate>
+                                        </b>
+                                    ),
+                                    anyPlatform: (
+                                        <b>
+                                            <Translate id="landing.landing-head.description.anyPlatform">
+                                                any platform
+                                            </Translate>
+                                        </b>
+                                    ),
+                                }}
+                            >
+                                {
+                                    "Testplane is a battle-hardened framework for creating tests at {anyScale}, {anyBrowser}, {anyPlatform}."
+                                }
+                            </Translate>
                         </div>
-                        <button className="mt-5 flex rounded-xl bg-[#6C47FF] px-6 py-3 font-bold text-white transition-colors hover:bg-[#7b59ff] active:bg-[#5e34ff]">
-                            Get started
-                            <ArrowHandDrawn className="ml-1 size-6" />
-                        </button>
+                        <Link to={latestVersion.path}>
+                            <button className="mt-5 flex rounded-xl bg-[#6C47FF] px-6 py-3 font-bold text-white transition-colors hover:bg-[#7b59ff] active:bg-[#5e34ff]">
+                                <Translate id="landing.getStartedButton">Get started</Translate>
+                                <ArrowHandDrawn className="ml-1 size-6" />
+                            </button>
+                        </Link>
                     </div>
                     <div className="-ml-6 hidden flex-grow basis-full overflow-hidden sm:block">
                         <AnimatedPlanet />
diff --git a/src/pages/versions.tsx b/src/pages/versions.tsx
new file mode 100644
index 0000000..8b8ec7a
--- /dev/null
+++ b/src/pages/versions.tsx
@@ -0,0 +1,95 @@
+import Layout from "@theme/Layout";
+import Heading from "@theme/Heading";
+import Translate from "@docusaurus/Translate";
+import Link from "@docusaurus/Link";
+import { useVersions, useLatestVersion } from "@docusaurus/plugin-content-docs/client";
+import useDocusaurusContext from "@docusaurus/core/lib/client/exports/useDocusaurusContext";
+
+function DocumentationLabel() {
+    return <Translate id="versionsPage.versionEntry.link">Documentation</Translate>;
+}
+
+function ReleaseNotesLabel() {
+    return <Translate id="versionsPage.versionEntry.releaseNotes">Release Notes</Translate>;
+}
+
+export default function Versions() {
+    const {
+        siteConfig: { organizationName, projectName: projectDocsName },
+    } = useDocusaurusContext();
+    const projectName = projectDocsName?.slice(0, projectDocsName?.indexOf("-docs"));
+
+    const docsPluginId = undefined; // Using default plugin
+    const versions = useVersions(docsPluginId);
+    const latestVersion = useLatestVersion(docsPluginId);
+    const currentVersion = versions.find(version => version.name === "current")!;
+    const repoUrl = `https://github.com/${organizationName!}/${projectName!}`;
+
+    return (
+        <Layout title={"Versions"}>
+            <main className="margin-vert--lg container">
+                <Heading as="h1">
+                    <Translate id="versionsPage.title">Testplane versions</Translate>
+                </Heading>
+
+                <div className="margin-bottom--lg">
+                    <Heading as="h3" id="next">
+                        <Translate id="versionsPage.current.title">
+                            Current version (Stable)
+                        </Translate>
+                    </Heading>
+                    <p>
+                        <Translate id="versionsPage.current.description">
+                            Here you can find the documentation for current released version.
+                        </Translate>
+                    </p>
+                    <table>
+                        <tbody>
+                            <tr>
+                                <th>{latestVersion.label}</th>
+                                <td>
+                                    <Link to={latestVersion.path}>
+                                        <DocumentationLabel />
+                                    </Link>
+                                </td>
+                                <td>
+                                    <Link to={`${repoUrl}/releases`}>
+                                        <ReleaseNotesLabel />
+                                    </Link>
+                                </td>
+                            </tr>
+                        </tbody>
+                    </table>
+                </div>
+            </main>
+
+            {currentVersion !== latestVersion && (
+                <div className="margin-bottom--lg">
+                    <Heading as="h3" id="latest">
+                        <Translate id="versionsPage.next.title">
+                            Next version (Unreleased)
+                        </Translate>
+                    </Heading>
+                    <p>
+                        <Translate id="versionsPage.next.description">
+                            Here you can find the documentation for work-in-process unreleased
+                            version.
+                        </Translate>
+                    </p>
+                    <table>
+                        <tbody>
+                            <tr>
+                                <th>{currentVersion.label}</th>
+                                <td>
+                                    <Link to={currentVersion.path}>
+                                        <DocumentationLabel />
+                                    </Link>
+                                </td>
+                            </tr>
+                        </tbody>
+                    </table>
+                </div>
+            )}
+        </Layout>
+    );
+}
diff --git a/src/scss/custom.scss b/src/scss/custom.scss
index 883ddd4..7239326 100644
--- a/src/scss/custom.scss
+++ b/src/scss/custom.scss
@@ -1,19 +1,55 @@
 @tailwind base;
+
+@layer base {
+    h1 {
+        @apply mb-4 text-4xl font-medium;
+    }
+
+    h2 {
+        @apply mb-4 text-3xl font-medium;
+    }
+
+    h3 {
+        @apply mb-3 text-xl font-medium;
+    }
+
+    p {
+        @apply mb-3;
+    }
+
+    code {
+        font-size: var(--ifm-code-font-size);
+        font-family: monospace, monospace !important;
+    }
+
+    a {
+        @apply text-indigo-600;
+
+        &:hover {
+            @apply text-indigo-400;
+            text-decoration: none !important;
+        }
+    }
+}
+
 @tailwind components;
 @tailwind utilities;
 
 /* Infima variables. */
 :root {
-    --ifm-color-primary: #2e8555;
-    --ifm-color-primary-dark: #29784c;
-    --ifm-color-primary-darker: #277148;
-    --ifm-color-primary-darkest: #205d3b;
-    --ifm-color-primary-light: #33925d;
-    --ifm-color-primary-lighter: #359962;
-    --ifm-color-primary-lightest: #3cad6e;
+    --ifm-color-primary: theme(colors.indigo.600);
+    --ifm-color-primary-dark: theme(colors.indigo.700);
+    --ifm-color-primary-darker: theme(colors.indigo.800);
+    --ifm-color-primary-darkest: theme(colors.indigo.900);
+    --ifm-color-primary-light: theme(colors.indigo.500);
+    --ifm-color-primary-lighter: theme(colors.indigo.400);
+    --ifm-color-primary-lightest: theme(colors.indigo.300);
     --ifm-code-font-size: 95%;
     --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
     --ifm-font-family-base: Jost, sans-serif;
+    --ifm-link-color: theme(colors.indigo.600);
+    --ifm-menu-color-active: theme(colors.indigo.600);
+    --ifm-breadcrumb-color-active: theme(colors.indigo.600);
 }
 
 /* Dark mode. */
@@ -40,6 +76,10 @@
 
     .navbar__link {
         @apply flex items-center font-medium text-gray-600 after:border-t-gray-600;
+
+        &::after {
+            transform: none;
+        }
     }
 
     .navbar__brand {
@@ -54,3 +94,26 @@
         display: none;
     }
 }
+
+.breadcrumbs svg,
+.theme-edit-this-page svg {
+    display: inline;
+}
+
+.menu {
+    padding: 0.5rem !important;
+}
+
+.theme-doc-markdown,
+article {
+    ul {
+        list-style: square;
+        padding-left: 2rem;
+    }
+
+    pre {
+        code {
+            font-size: 95%;
+        }
+    }
+}
diff --git a/src/theme/Footer/Layout/index.tsx b/src/theme/Footer/Layout/index.tsx
index fb2e2c4..0120e03 100644
--- a/src/theme/Footer/Layout/index.tsx
+++ b/src/theme/Footer/Layout/index.tsx
@@ -6,6 +6,7 @@ import GithubIcon from "@site/static/icons/github.svg";
 import StackoverflowIcon from "@site/static/icons/stackoverflow.svg";
 import TelegramIcon from "@site/static/icons/telegram.svg";
 import useBaseUrl from "@docusaurus/core/lib/client/exports/useBaseUrl";
+import Translate from "@docusaurus/Translate";
 
 export default function FooterLayout({ links, copyright }: Props): JSX.Element {
     const SOCIAL_LINKS = [
@@ -26,15 +27,17 @@ export default function FooterLayout({ links, copyright }: Props): JSX.Element {
 
     return (
         <footer className={styles.footer} style={{ backgroundImage: grainyBg }}>
-            <div className="container max-w-screen-lg py-10">
+            <div className="container !max-w-screen-lg py-10">
                 <div className="flex flex-wrap justify-between border-b-2 border-white/50 pb-10">
                     <div className="basis-full p-1">
                         <div className="flex items-center font-mono text-lg font-bold text-violet-50">
                             testplane
                         </div>
                         <div className={"mt-3 max-w-[75vw] text-lg font-medium text-white/60"}>
-                            Fast, scalable and robust end-to-end testing framework for the
-                            ever-evolving web landscape.
+                            <Translate id="footer.slogan">
+                                Fast, scalable and robust end-to-end testing framework for the
+                                ever-evolving web landscape.
+                            </Translate>
                         </div>
                         <a
                             className={
@@ -44,7 +47,7 @@ export default function FooterLayout({ links, copyright }: Props): JSX.Element {
                             target="_blank"
                             rel="noreferrer"
                         >
-                            Contact us
+                            <Translate id="footer.contact-us">Contact us</Translate>
                             <ArrowLinkIcon className={"ml-1 size-4"} />
                         </a>
                     </div>
diff --git a/static/img/docs/guides/how-to-check-test-stability.total-failure.png b/static/img/docs/guides/how-to-check-test-stability.total-failure.png
new file mode 100644
index 0000000..201b2de
Binary files /dev/null and b/static/img/docs/guides/how-to-check-test-stability.total-failure.png differ
diff --git a/static/img/docs/guides/how-to-check-test-stability.total-success.png b/static/img/docs/guides/how-to-check-test-stability.total-success.png
new file mode 100644
index 0000000..251f04e
Binary files /dev/null and b/static/img/docs/guides/how-to-check-test-stability.total-success.png differ
diff --git a/static/img/docs/guides/how-to-check-test-stability.unstable-test.png b/static/img/docs/guides/how-to-check-test-stability.unstable-test.png
new file mode 100644
index 0000000..e2e411f
Binary files /dev/null and b/static/img/docs/guides/how-to-check-test-stability.unstable-test.png differ
diff --git a/static/img/docs/guides/how-to-get-report.html-reporter.png b/static/img/docs/guides/how-to-get-report.html-reporter.png
new file mode 100644
index 0000000..9fe62b2
Binary files /dev/null and b/static/img/docs/guides/how-to-get-report.html-reporter.png differ
diff --git a/static/img/docs/guides/how-to-hide-scrollbars.diff-in-screenshot.png b/static/img/docs/guides/how-to-hide-scrollbars.diff-in-screenshot.png
new file mode 100644
index 0000000..6ab4736
Binary files /dev/null and b/static/img/docs/guides/how-to-hide-scrollbars.diff-in-screenshot.png differ
diff --git a/static/img/docs/guides/how-to-minify-screenshots.diff-in-screenshot.png b/static/img/docs/guides/how-to-minify-screenshots.diff-in-screenshot.png
new file mode 100644
index 0000000..c7abb0e
Binary files /dev/null and b/static/img/docs/guides/how-to-minify-screenshots.diff-in-screenshot.png differ
diff --git a/static/img/docs/guides/how-to-use-cdp.remote-scheme.png b/static/img/docs/guides/how-to-use-cdp.remote-scheme.png
new file mode 100644
index 0000000..61be376
Binary files /dev/null and b/static/img/docs/guides/how-to-use-cdp.remote-scheme.png differ
diff --git a/static/img/docs/html-reporter/html-reporter.overview.png b/static/img/docs/html-reporter/html-reporter.overview.png
new file mode 100644
index 0000000..9fe62b2
Binary files /dev/null and b/static/img/docs/html-reporter/html-reporter.overview.png differ
diff --git a/static/img/docs/reference/testplane-events-dark-mode.png b/static/img/docs/reference/testplane-events-dark-mode.png
new file mode 100644
index 0000000..8aa2b84
Binary files /dev/null and b/static/img/docs/reference/testplane-events-dark-mode.png differ
diff --git a/static/img/docs/reference/testplane-events-light-mode.png b/static/img/docs/reference/testplane-events-light-mode.png
new file mode 100644
index 0000000..b3da037
Binary files /dev/null and b/static/img/docs/reference/testplane-events-light-mode.png differ
diff --git a/static/img/docs/reference/webdriver-vs-cdp.chrome-devtools-protocol.png b/static/img/docs/reference/webdriver-vs-cdp.chrome-devtools-protocol.png
new file mode 100644
index 0000000..ce82538
Binary files /dev/null and b/static/img/docs/reference/webdriver-vs-cdp.chrome-devtools-protocol.png differ
diff --git a/static/img/docs/reference/webdriver-vs-cdp.webdriver-protocol.png b/static/img/docs/reference/webdriver-vs-cdp.webdriver-protocol.png
new file mode 100644
index 0000000..d0886b0
Binary files /dev/null and b/static/img/docs/reference/webdriver-vs-cdp.webdriver-protocol.png differ