docs(quickstart): some improvements

docs/quickstart/running-tests.mdx

@@ -18,7 +18,7 @@ You can also run tests in `gui` mode. To do this, execute the command:
 npx testplane gui
 ```
 
-### Running a specific test
+### Running a specific test {#the_grep_option}
 
 Consider the following set of tests:
 
@@ -96,7 +96,7 @@ describe("Browser specific tests", () => {
 });
 ```
 
-### Running a test from a specific file
+### Running a test from a specific file {#running_a_specific_file}
 
 To run tests from a specific file, execute the command:
 

docs/quickstart/usage-in-ci.mdx

@@ -1,6 +1,53 @@
 ---
 sidebar_position: 4
-draft: true
 ---
 
 # Usage in CI
+
+Testplane can be easily integrated into any CI system. For GitHub Actions, we recommend using the official action [gemini-testing/gh-actions-testplane](https://github.com/gemini-testing/gh-actions-testplane), which automatically caches browsers and generates reports.
+
+## GitHub Actions Setup
+
+Create a `.github/workflows/testplane.yml` file in your repository root:
+
+```yaml title=".github/workflows/testplane.yml"
+name: Testplane Tests
+
+on:
+    push:
+        branches: [main, master]
+    pull_request:
+        branches: [main, master]
+
+jobs:
+    test:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: "20"
+                  cache: "npm"
+
+            - run: npm ci
+
+            - uses: gemini-testing/gh-actions-testplane@v1
+              with:
+                  browser: "chrome,firefox" # Optional: list of browsers
+```
+
+## Additional Features
+
+The action supports additional configuration parameters:
+
+-   `config-path` — path to config file (default: `testplane.config.ts`)
+-   `set` — run specific test sets
+-   `grep` — filter tests by pattern
+-   `storybook` — integration with [@testplane/storybook](https://github.com/gemini-testing/testplane-storybook)
+
+For more details on parameters and advanced usage scenarios, see the [GitHub Actions setup guide](../guides/how-to-run-on-github.mdx).
+
+## Other CI Systems
+
+For more details on configuring Testplane for other CI systems, refer to the [configuration documentation](../reference/config/main.mdx).

i18n/ru/docusaurus-plugin-content-docs/current/quickstart/index.mdx

@@ -4,23 +4,22 @@ sidebar_position: 1
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import Admonition from "@theme/Admonition";
 
 # Установка и настройка
 
 ## Системные требования
 
-Чтобы начать работу с testplane, установите `Node.js` версии 18.0 и выше.
+Чтобы начать работу с Testplane, установите `Node.js` версии 18.0 и выше.
 
 ## Установка {#install}
 
-Для запуска установщика testplane с помощью `npm` выполните следующую команду:
+Для запуска установщика Testplane с помощью `npm` выполните следующую команду:
 
 ```bash
 npm init testplane@latest YOUR_PROJECT_PATH
 ```
 
-Чтобы настроить проект, а не использовать дефолты при его инициализации, укажите опцию `-v`.
+Чтобы настроить проект в интерактивном режиме с дополнительными параметрами (выбор пакетного менеджера, установка плагинов), укажите опцию <nobr>`-v`</nobr>.
 
 После выполнения команды установки в директории проекта появится следующий набор файлов и папок:
 
@@ -38,25 +37,23 @@ testplane.config.ts
 
 В файле `testplane.config.ts` содержится базовый набор настроек для запуска тестов:
 
-```typescript
+```typescript title="testplane.config.ts"
+import { setupBrowser } from "@testplane/testing-library";
+import type { WdioBrowser } from "testplane";
+
 export default {
     gridUrl: "local",
     baseUrl: "http://localhost",
-    pageLoadTimeout: 0,
-    httpTimeout: 60000,
+    pageLoadTimeout: 20000,
+    httpTimeout: 20000,
     testTimeout: 90000,
     resetCursor: false,
-
-    // В параметре sets содержится информация о директории, в которой находятся тесты
-    // и перечень браузеров, в которых они будут запускаться:
     sets: {
         desktop: {
             files: ["testplane-tests/**/*.testplane.(t|j)s"],
             browsers: ["chrome", "firefox"],
         },
     },
-
-    // В поле `browsers` описана конфигурация используемых браузеров:
     browsers: {
         chrome: {
             headless: true,
@@ -71,7 +68,9 @@ export default {
             },
         },
     },
-
+    prepareBrowser: (browser: WdioBrowser) => {
+        setupBrowser(browser);
+    },
     plugins: {
         "html-reporter/testplane": {
             enabled: true,
@@ -80,13 +79,77 @@ export default {
             diffMode: "3-up-scaled",
         },
     },
-};
+} satisfies import("testplane").ConfigInput;
 ```
 
+### Основные параметры конфигурации
+
+-   `gridUrl` — где запускать браузеры: `"local"` для локального запуска или URL для Selenium Grid или облака (например, BrowserStack, Sauce Labs).
+-   `sets` — группы тестов для разных браузеров (например, набор тестов для десктопных Chrome или Firefox и набор для мобильного Safari). Подробнее: [справочник по sets](https://github.com/gemini-testing/testplane-docs/pull/reference/config/sets.mdx).
+-   `testTimeout` — максимальное время выполнения теста в миллисекундах, после превышения тест прерывается.
+-   `pageLoadTimeout` — максимальное время ожидания загрузки страницы.
+-   `browsers` — конфигурация браузеров; `headless: true` — запуск без UI. Подробнее: [Браузеры](https://github.com/gemini-testing/testplane-docs/pull/basic-guides/managing-browsers.mdx).
+-   `prepareBrowser` — хук перед тестами; в конфиге выше вызывает `setupBrowser(browser)` и добавляет методы Testing Library.
+-   `plugins` — плагины; в конфиге выше `html-reporter` для интерактивных отчетов (скриншоты, логи, отладка). Подробнее: [HTML Reporter](https://github.com/gemini-testing/testplane-docs/pull/html-reporter/overview.mdx).
+
+Полный список параметров конфигурации ищите в [справочнике по конфигурации](../reference/config/main.mdx).
+
 Чтобы загрузить браузеры, описанные в конфиге, отдельно от запуска самого Testplane, выполните команду:
 
 ```bash
 npx testplane install-deps
 ```
 
-Без предварительного запуска команды, недостающие браузеры будут автоматически загружены с первым запуском Testplane.
+Без предварительного запуска команды недостающие браузеры будут автоматически загружены с первым запуском Testplane.
+
+## Первый запуск {#first-run}
+
+После установки и настройки запустите тестовый пример, который был создан автоматически:
+
+```bash
+npx testplane
+```
+
+### Что происходит при первом запуске
+
+Testplane автоматически выполнит следующие действия:
+
+1. Загрузит браузеры: если вы не запускали `install-deps`, Testplane скачает Chrome и Firefox
+2. Запустит тест: выполнит пример из `testplane-tests/example.testplane.ts`
+3. Создаст отчет: сгенерирует HTML-репорт в папке `testplane-report/`
+
+### Просмотр результатов
+
+После завершения тестов откройте интерактивный отчет:
+
+```bash
+npx testplane gui
+```
+
+Команда запустит локальный сервер и откроет отчет в браузере. В интерфейсе вы увидите:
+
+-   Список пройденных тестов
+-   Статистику выполнения
+-   Скриншоты (если тест использует `assertView`)
+-   Логи выполнения
+
+### Ожидаемый результат
+
+Если все настроено корректно, вы увидите:
+
+```
+✔ test examples › docs search test [chrome] - 3.2s
+✔ test examples › docs search test [firefox] - 3.5s
+
+Total: 2 Passed: 2 Failed: 0 Skipped: 0 Retries: 0
+```
+
+Для успешного прохождения тестам нужен доступ к [testplane.io](https://testplane.io/).
+
+## Что дальше?
+
+Теперь, когда Testplane настроен и работает, вы можете:
+
+-   [Написать свои тесты](./writing-tests.mdx): структура тестов, селекторы и основные команды
+-   [Запустить и отладить тесты](./running-tests.mdx): фильтрация, GUI-режим, отладка
+-   [Настроить CI/CD](./usage-in-ci.mdx): автозапуск тестов в GitHub Actions