chore: add more info about start and stop

Author: kravetsone

docs/ru/updates/overview.md

@@ -11,7 +11,85 @@ head:
         content: "телеграм бот, фреймворк, как создать бота, Telegram, Telegram Bot API, GramIO, TypeScript, JavaScript, Node.JS, Nodejs, Deno, Bun, обработка обновлений, context объект, middleware, события бота, Update типы, обработчики событий, next функция, цепочка middleware, message события, callback_query события, фильтрация обновлений, маршрутизация событий, edited_message, channel_post, inline_query, polling, webhook, типы обновлений, регистрация обработчиков"
 ---
 
-# Контекст
+# Обработка обновлений
+
+## Start
+
+Метод `start` запускает процесс получения обновлений от Telegram для вашего бота. В зависимости от переданных параметров, бот может использовать long-polling или webhook для получения событий. Этот метод инициализирует бота, подгружает [lazy плагины](/docs/ru/plugins/lazy-load) и вызывает хук [`onStart`](/docs/ru/plugins/hooks#onstart).
+
+**Сигнатура:**
+
+```ts
+start(options?): Promise<BotInfo>
+```
+
+**Параметры:**
+
+-   `options` — объект с настройками запуска:
+    -   `webhook` — параметры для запуска через webhook (`true`, строка-URL или объект с параметрами).
+    -   `longPolling` — параметры для long-polling (например, таймауты).
+    -   `dropPendingUpdates` — сбрасывать ли неотправленные обновления при запуске.
+    -   `allowedUpdates` — список типов обновлений, которые бот будет получать.
+    -   `deleteWebhook` — как поступать с существующим webhook при запуске long-polling.
+
+> [!IMPORTANT]
+>
+> **Особенности параметров:**
+>
+> -   Если указать `webhook: true`, GramIO не будет пытаться установить webhook самостоятельно — предполагается, что вы уже настроили его. В этом случае бот просто начнёт принимать обновления через уже существующий webhook.
+>
+> -   Параметр `deleteWebhook` управляет тем, что делать с существующим webhook при запуске long-polling:
+>     -   Если `deleteWebhook: true`, бот всегда удаляет webhook перед запуском long-polling.
+>     -   Если `deleteWebhook: "on-conflict-with-polling"`, webhook будет удалён только если он мешает запуску long-polling (когда Telegram отвечает на запрос `getUpdates` с ошибкой конфликта).
+>     -   Если не указано, используется поведение по умолчанию (`on-conflict-with-polling`).
+
+```ts
+import { Bot } from "gramio";
+
+const bot = new Bot(process.env.BOT_TOKEN)
+    .command("start", (ctx) => ctx.send("Привет!"))
+    .onStart(console.log);
+
+await bot.start({
+    longPolling: { timeout: 10 },
+    dropPendingUpdates: true,
+});
+```
+
+**Описание работы:**
+
+-   Если не указан webhook, запускается long-polling.
+-   Если указан webhook, настраивается webhook и бот начинает принимать обновления через HTTP.
+-   Вызывает хук [`onStart`](/docs/ru/plugins/hooks#onstart).
+-   Можно сбросить старые обновления при запуске.
+
+## Stop
+
+Метод `stop` завершает приём обновлений и корректно останавливает все внутренние процессы бота. Вызываются хуки завершения (`onStop`), очищается очередь обновлений.
+
+**Сигнатура:**
+
+```ts
+stop(timeout?): Promise<void>
+```
+
+**Параметры:**
+
+-   `timeout` — время ожидания завершения обработки очереди обновлений (по умолчанию 3000 мс).
+
+**Пример использования:**
+
+```ts
+await bot.stop();
+```
+
+**Описание работы:**
+
+-   Останавливает long-polling или webhook (если был запущен).
+-   Дожидается завершения обработки всех текущих обновлений.
+-   Вызывает хук [`onStop`](/docs/ru/plugins/hooks#onstop).
+
+## Контекст
 
 ## Прослушивание всех событий
 
@@ -143,4 +221,4 @@ const bot = new Bot(process.env.BOT_TOKEN as string)
         context.k;
         //       ^|
     });
-``` 
+```

docs/tma/init-data.md

@@ -189,6 +189,6 @@ const app = new Elysia()
     .use(authElysia)
     .get("/user", ({ user }) => {
         user;
-        //  ^?
+        // ^?
     });
 ```

docs/updates/overview.md

@@ -1,3 +1,79 @@
+# Update handling
+
+## Start
+
+The `start` method launches the process of receiving updates from Telegram for your bot. Depending on the parameters provided, the bot can use long-polling or webhook to receive events. This method initializes the bot, loads [lazy plugins](/plugins/lazy-load), and calls the [`onStart`](/plugins/hooks#onstart) hook.
+
+**Signature:**
+
+```ts
+start(options?): Promise<BotInfo>
+```
+
+**Parameters:**
+
+-   `options` — an object with launch settings:
+    -   `webhook` — parameters for starting via webhook (`true`, a URL string, or an object with parameters).
+    -   `longPolling` — parameters for long-polling (for example, timeouts).
+    -   `dropPendingUpdates` — whether to drop pending updates on start.
+    -   `allowedUpdates` — a list of update types the bot will receive.
+    -   `deleteWebhook` — how to handle an existing webhook when starting long-polling.
+
+> [!IMPORTANT] > **Parameter details:**
+>
+> -   If you set `webhook: true`, GramIO will not attempt to set the webhook itself — it assumes you have already configured it. In this case, the bot will simply start receiving updates via the existing webhook.
+>
+> -   The `deleteWebhook` parameter controls what to do with an existing webhook when starting long-polling:
+>     -   If `deleteWebhook: true`, the bot will always delete the webhook before starting long-polling.
+>     -   If `deleteWebhook: "on-conflict-with-polling"`, the webhook will only be deleted if it interferes with starting long-polling (when Telegram responds to `getUpdates` with a conflict error).
+>     -   If not specified, the default behavior (`on-conflict-with-polling`) is used.
+
+```ts
+import { Bot } from "gramio";
+
+const bot = new Bot(process.env.BOT_TOKEN)
+    .command("start", (ctx) => ctx.send("Hi!"))
+    .onStart(console.log);
+
+await bot.start({
+    longPolling: { timeout: 10 },
+    dropPendingUpdates: true,
+});
+```
+
+**How it works:**
+
+-   If webhook is not specified, long-polling is started.
+-   If webhook is specified, the webhook is set up and the bot starts receiving updates via HTTP.
+-   Calls the [`onStart`](/plugins/hooks#onstart) hook.
+-   You can drop old updates on start.
+
+## Stop
+
+The `stop` method stops receiving updates and gracefully shuts down all internal bot processes. The [`onStop`](/plugins/hooks#onstop) hook is called, and the update queue is cleared.
+
+**Signature:**
+
+```ts
+stop(timeout?): Promise<void>
+```
+
+**Parameters:**
+
+-   `timeout` — the time to wait for the update queue to finish processing (default is 3000 ms).
+
+**Example usage:**
+
+```ts
+await bot.stop();
+```
+
+**How it works:**
+
+-   Stops long-polling or webhook (if it was running).
+-   Waits for all current updates to finish processing.
+-   Calls the [`onStop`](/plugins/hooks#onstop) hook.
+
 # Context
 
 ## Listen to all events