Update documentation and code snippets

docs/locales/en/LC_MESSAGES/root/quickstart.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Argenta \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-03 19:01+0300\n"
+"POT-Creation-Date: 2025-12-02 22:27+0300\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: en\n"
@@ -21,7 +21,7 @@ msgstr ""
 
 #: ../../root/quickstart.rst:4
 msgid "Быстрый старт"
-msgstr "Quick Start"
+msgstr ""
 
 #: ../../root/quickstart.rst:6
 msgid ""
@@ -31,8 +31,8 @@ msgstr ""
 
 #: ../../root/quickstart.rst:8
 msgid ""
-"**Простой пример**: Быстрое знакомство с основными компонентами, такими "
-"как `App`, `Command` и `Router`."
+"**Простой пример**: Минимальное приложение, быстрое знакомство с "
+"основными компонентами."
 msgstr ""
 
 #: ../../root/quickstart.rst:9
@@ -45,142 +45,81 @@ msgstr ""
 msgid "Простой пример"
 msgstr ""
 
-#: ../../root/quickstart.rst:14
+#: ../../root/quickstart.rst:14 ../../root/quickstart.rst:38
+msgid "**Установка**"
+msgstr ""
+
+#: ../../root/quickstart.rst:20
 msgid ""
 "Этот пример демонстрирует абсолютный минимум, необходимый для создания и "
 "запуска приложения. Вы можете скопировать этот код, запустить его и сразу"
 " увидеть результат."
 msgstr ""
 
-#: ../../root/quickstart.rst:20 ../../root/quickstart.rst:68
+#: ../../root/quickstart.rst:26 ../../root/quickstart.rst:76
 msgid "**Результат**"
 msgstr ""
 
-#: ../../root/quickstart.rst:22
+#: ../../root/quickstart.rst:28
 msgid "Simple App Example"
 msgstr ""
 
-#: ../../root/quickstart.rst:26
+#: ../../root/quickstart.rst:34
 msgid "Более сложный пример: Менеджер задач"
 msgstr ""
 
-#: ../../root/quickstart.rst:28
+#: ../../root/quickstart.rst:36
 msgid ""
 "В этом руководстве мы создадим простое, но полнофункциональное "
 "CLI-приложение «Менеджер задач», которое продемонстрирует ключевые "
 "возможности Argenta."
 msgstr ""
 
-#: ../../root/quickstart.rst:30
-msgid "**Установка**"
-msgstr ""
-
-#: ../../root/quickstart.rst:36
+#: ../../root/quickstart.rst:44
 msgid "**Определение моделей данных и репозитория**"
 msgstr ""
 
-#: ../../root/quickstart.rst:38
-msgid ""
-"Сначала определим модели данных для задачи и репозиторий для их хранения."
-" Это будет наша \"бизнес-логика\"."
-msgstr ""
-
-#: ../../root/quickstart.rst:44
-msgid "**Создание провайдера для DI**"
-msgstr ""
-
 #: ../../root/quickstart.rst:46
-msgid ""
-"Чтобы Argenta могла внедрять `TaskRepository` в наши обработчики, мы "
-"создадим провайдер для `dishka`."
+msgid "Сначала определим модели данных для задачи и репозиторий для их хранения."
 msgstr ""
 
 #: ../../root/quickstart.rst:52
-msgid "**Создание обработчиков команд**"
+msgid "**Создание провайдера для DI**"
 msgstr ""
 
 #: ../../root/quickstart.rst:54
 msgid ""
-"Теперь создадим обработчики для команд `add-task` и `list-tasks`. "
-"Обратите внимание, как мы используем флаги и внедряем `TaskRepository`."
+"Чтобы Argenta могла внедрять ``TaskRepository`` в наши обработчики, мы "
+"создадим провайдер для ``dishka``."
 msgstr ""
 
 #: ../../root/quickstart.rst:60
-msgid "**Сборка и запуск приложения**"
+msgid "**Создание обработчиков команд**"
 msgstr ""
 
 #: ../../root/quickstart.rst:62
 msgid ""
-"Наконец, соберем все вместе: создадим экземпляр `App`, подключим роутер и"
-" провайдер, а затем запустим приложение."
+"Теперь создадим обработчики для команд ``add-task`` и ``list-tasks``. "
+"Обратите внимание, как мы используем флаги и внедряем ``TaskRepository``."
+msgstr ""
+
+#: ../../root/quickstart.rst:68
+msgid "**Сборка и запуск приложения**"
 msgstr ""
 
 #: ../../root/quickstart.rst:70
 msgid ""
-"Теперь вы можете запустить `main.py` и взаимодействовать с вашим новым "
+"Наконец, соберем все вместе: создадим экземпляр ``App``, подключим роутер"
+" и провайдер, а затем запустим приложение."
+msgstr ""
+
+#: ../../root/quickstart.rst:78
+msgid ""
+"Теперь вы можете запустить ``main.py`` и взаимодействовать с вашим новым "
 "CLI-приложением."
 msgstr ""
 
-#: ../../root/quickstart.rst:72
+#: ../../root/quickstart.rst:80
 msgid "Task Manager Example"
 msgstr ""
 
-#~ msgid ""
-#~ "**Определение роутера и хэндлеров**, за "
-#~ "регистрацию функции как обработчика отвечает"
-#~ " декоратор ``@router.command``, хэндлер всегда"
-#~ " должен принимать аргумент с типом "
-#~ "``Response``, подробнее в :ref:`разделе "
-#~ "<Response>`."
-#~ msgstr ""
-
-#~ msgid ""
-#~ "**Определение приложения и оркестратора**, для"
-#~ " запуска приложения необходимо вызвать "
-#~ "``.include_router()`` у созданного приложения "
-#~ "и передать ему раннее созданный роутер,"
-#~ " после этого необходимо вызвать "
-#~ "``.start_polling()`` у созданного оркестратора "
-#~ "и передать ему созданное приложение."
-#~ msgstr ""
-
-#~ msgid "**Запуск приложения**, запускаем приложение как обычный процесс."
-#~ msgstr ""
-
-#~ msgid ""
-#~ "**Определение роутера и хэндлеров**. За "
-#~ "регистрацию функции как обработчика отвечает"
-#~ " декоратор ``@router.command``, хэндлер всегда"
-#~ " должен принимать аргумент с типом "
-#~ "``Response``, подробнее в :ref:`разделе "
-#~ "<Response>`."
-#~ msgstr ""
-
-#~ msgid "**Установка** ``Argenta``"
-#~ msgstr ""
-
-#~ msgid ""
-#~ "**Определение роутера и хэндлеров**. За "
-#~ "регистрацию функции как обработчика отвечает"
-#~ " декоратор ``@router.command``, хэндлер всегда"
-#~ " должен принимать аргумент с типом "
-#~ "``Response``, подробнее в :ref:`разделе "
-#~ "<root_api_response>`."
-#~ msgstr ""
-
-#~ msgid ""
-#~ "**Определение приложения и оркестратора**. Для"
-#~ " запуска приложения необходимо вызвать "
-#~ "``.include_router()`` у созданного приложения "
-#~ "и передать ему раннее созданный роутер,"
-#~ " после этого необходимо вызвать "
-#~ "``.start_polling()`` у созданного оркестратора "
-#~ "и передать ему созданное приложение."
-#~ msgstr ""
-
-#~ msgid "**Запуск приложения**. Запускаем приложение как обычный скрипт."
-#~ msgstr ""
-
-#~ msgid "Quickstart Example"
-#~ msgstr ""
-