Update documentation

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

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Argenta \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-12-02 22:27+0300\n"
+"POT-Creation-Date: 2025-12-04 20:39+0300\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: en\n"
@@ -27,28 +27,30 @@ msgid ""
 "В этом руководстве мы рассмотрим два примера создания CLI-приложения с "
 "помощью Argenta:"
 msgstr ""
-"In this guide, we will look at two examples of creating a CLI application with Argenta:"
+"In this guide, we will look at two examples of creating a CLI application"
+" with Argenta:"
 
 #: ../../root/quickstart.rst:8
 msgid ""
-"**Простой пример**: Минимальное приложение, быстрое знакомство с "
+"**Простой пример**: минимальное приложение для быстрого знакомства с "
 "основными компонентами."
 msgstr ""
-"**Simple example**: A minimal application, quick introduction to the main components."
+"**Simple example**: a minimal application for quick introduction to the "
+"main components."
 
 #: ../../root/quickstart.rst:9
 msgid ""
-"**Более сложный пример**: Полнофункциональное приложение «Менеджер задач»"
+"**Более сложный пример**: полнофункциональное приложение «Менеджер задач»"
 " с внедрением зависимостей и бизнес-логикой."
 msgstr ""
-"**More complex example**: A full-featured \"Task Manager\" application with "
-"dependency injection and business logic."
+"**More complex example**: a full-featured \"Task Manager\" application "
+"with dependency injection and business logic."
 
 #: ../../root/quickstart.rst:12
 msgid "Простой пример"
 msgstr "Simple Example"
 
-#: ../../root/quickstart.rst:14 ../../root/quickstart.rst:38
+#: ../../root/quickstart.rst:14 ../../root/quickstart.rst:74
 msgid "**Установка**"
 msgstr "**Installation**"
 
@@ -58,81 +60,123 @@ msgid ""
 "запуска приложения. Вы можете скопировать этот код, запустить его и сразу"
 " увидеть результат."
 msgstr ""
-"This example demonstrates the absolute minimum required to create and run an "
-"application. You can copy this code, run it, and immediately see the result."
+"This example demonstrates the absolute minimum required to create and run"
+" an application. You can copy this code, run it, and immediately see the "
+"result."
 
-#: ../../root/quickstart.rst:26 ../../root/quickstart.rst:76
+#: ../../root/quickstart.rst:26
+msgid "**Запуск**"
+msgstr "**Running**"
+
+#: ../../root/quickstart.rst:28
+msgid "Сохраните код в файл (например, ``main.py``) и запустите:"
+msgstr "Save the code to a file (for example, ``main.py``) and run:"
+
+#: ../../root/quickstart.rst:34 ../../root/quickstart.rst:112
 msgid "**Результат**"
 msgstr "**Result**"
 
-#: ../../root/quickstart.rst:28
-msgid "Simple App Example"
-msgstr ""
-
-#: ../../root/quickstart.rst:34
-msgid "Более сложный пример: Менеджер задач"
-msgstr "More Complex Example: Task Manager"
-
 #: ../../root/quickstart.rst:36
-msgid ""
-"В этом руководстве мы создадим простое, но полнофункциональное "
-"CLI-приложение «Менеджер задач», которое продемонстрирует ключевые "
-"возможности Argenta."
-msgstr ""
-"In this guide, we will create a simple but full-featured CLI application \"Task "
-"Manager\" that will demonstrate the key features of Argenta."
+msgid "Simple App Example"
+msgstr "Simple App Example"
+
+#: ../../root/quickstart.rst:42
+msgid "Промежуточный пример: Калькулятор с флагами"
+msgstr "Intermediate Example: Calculator with Flags"
 
 #: ../../root/quickstart.rst:44
+msgid ""
+"Прежде чем перейти к сложному примеру с DI, рассмотрим промежуточный "
+"вариант — калькулятор, который использует флаги для управления "
+"поведением."
+msgstr ""
+"Before moving to a complex example with DI, let's consider an "
+"intermediate option — a calculator that uses flags to control behavior."
+
+#: ../../root/quickstart.rst:50
+msgid "**Запуск:**"
+msgstr "**Running:**"
+
+#: ../../root/quickstart.rst:52
+msgid "Сохраните код в файл ``calculator.py`` и запустите:"
+msgstr "Save the code to a file ``calculator.py`` and run:"
+
+#: ../../root/quickstart.rst:58
+msgid "**Использование:**"
+msgstr "**Usage:**"
+
+#: ../../root/quickstart.rst:65
+msgid ""
+"Этот пример показывает, как работать с флагами без использования DI. "
+"Теперь перейдём к более сложному примеру."
+msgstr ""
+"This example shows how to work with flags without using DI. Now let's "
+"move on to a more complex example."
+
+#: ../../root/quickstart.rst:70
+msgid "Сложный пример: Менеджер задач с DI"
+msgstr "Complex Example: Task Manager with DI"
+
+#: ../../root/quickstart.rst:72
+msgid ""
+"В этом руководстве мы создадим полнофункциональное CLI-приложение "
+"«Менеджер задач», которое продемонстрирует работу с внедрением "
+"зависимостей."
+msgstr ""
+"In this guide, we will create a full-featured CLI application \"Task "
+"Manager\" that will demonstrate working with dependency injection."
+
+#: ../../root/quickstart.rst:80
 msgid "**Определение моделей данных и репозитория**"
 msgstr "**Defining Data Models and Repository**"
 
-#: ../../root/quickstart.rst:46
+#: ../../root/quickstart.rst:82
 msgid "Сначала определим модели данных для задачи и репозиторий для их хранения."
 msgstr "First, let's define data models for tasks and a repository to store them."
 
-#: ../../root/quickstart.rst:52
+#: ../../root/quickstart.rst:88
 msgid "**Создание провайдера для DI**"
 msgstr "**Creating a Provider for DI**"
 
-#: ../../root/quickstart.rst:54
+#: ../../root/quickstart.rst:90
 msgid ""
 "Чтобы Argenta могла внедрять ``TaskRepository`` в наши обработчики, мы "
 "создадим провайдер для ``dishka``."
 msgstr ""
-"To allow Argenta to inject ``TaskRepository`` into our handlers, we will create a "
-"provider for ``dishka``."
+"To allow Argenta to inject ``TaskRepository`` into our handlers, we will "
+"create a provider for ``dishka``."
 
-#: ../../root/quickstart.rst:60
+#: ../../root/quickstart.rst:96
 msgid "**Создание обработчиков команд**"
 msgstr "**Creating Command Handlers**"
 
-#: ../../root/quickstart.rst:62
+#: ../../root/quickstart.rst:98
 msgid ""
 "Теперь создадим обработчики для команд ``add-task`` и ``list-tasks``. "
 "Обратите внимание, как мы используем флаги и внедряем ``TaskRepository``."
 msgstr ""
-"Now let's create handlers for the ``add-task`` and ``list-tasks`` commands. Notice "
-"how we use flags and inject ``TaskRepository``."
+"Now let's create handlers for the ``add-task`` and ``list-tasks`` "
+"commands. Notice how we use flags and inject ``TaskRepository``."
 
-#: ../../root/quickstart.rst:68
+#: ../../root/quickstart.rst:104
 msgid "**Сборка и запуск приложения**"
 msgstr "**Building and Running the Application**"
 
-#: ../../root/quickstart.rst:70
+#: ../../root/quickstart.rst:106
 msgid ""
 "Наконец, соберем все вместе: создадим экземпляр ``App``, подключим роутер"
 " и провайдер, а затем запустим приложение."
 msgstr ""
-"Finally, let's put it all together: create an ``App`` instance, connect the router "
-"and provider, and then run the application."
+"Finally, let's put it all together: create an ``App`` instance, connect "
+"the router and provider, and then run the application."
 
-#: ../../root/quickstart.rst:78
+#: ../../root/quickstart.rst:114
 msgid ""
 "Теперь вы можете запустить ``main.py`` и взаимодействовать с вашим новым "
 "CLI-приложением."
 msgstr "Now you can run ``main.py`` and interact with your new CLI application."
 
-#: ../../root/quickstart.rst:80
+#: ../../root/quickstart.rst:116
 msgid "Task Manager Example"
-msgstr ""
+msgstr "Task Manager Example"