Update documentation

docs/locales/en/LC_MESSAGES/index.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:41+0300\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: en\n"
@@ -54,7 +54,9 @@ msgstr "What is it and why?"
 msgid ""
 "**Библиотека для построения модульных CLI-приложений с простым и приятным"
 " API.**"
-msgstr "**A library for building modular CLI applications with a simple and pleasant API.**"
+msgstr ""
+"**A library for building modular CLI applications with a simple and "
+"pleasant API.**"
 
 #: ../../index.rst:14
 msgid ""
@@ -64,8 +66,9 @@ msgid ""
 "предоставляя для этого удобные абстракции."
 msgstr ""
 "If you have functionality that you want to provide as a CLI application, "
-"Argenta will help you with that. The main goal of the library is to enable "
-"developers to focus on implementing their ideas by providing convenient abstractions."
+"Argenta will help you with that. The main goal of the library is to "
+"enable developers to focus on implementing their ideas by providing "
+"convenient abstractions."
 
 #: ../../index.rst:17
 msgid "App example"
@@ -74,24 +77,30 @@ msgstr ""
 #: ../../index.rst:20
 msgid ""
 "Argenta предназначена для создания приложений, работающих в собственном "
-"контексте (scope). Это означает, что при запуске пользователь входит в "
-"интерактивную сессию, где ему доступна вся реализованная вами "
-"функциональность."
+"контексте (scope). Это означает, что приложение запускается один раз и "
+"создаёт интерактивную сессию, похожую на Python REPL или MySQL консоль. "
+"При запуске пользователь входит в эту сессию, где ему доступна вся "
+"реализованная вами функциональность."
 msgstr ""
-"Argenta is designed for creating applications that work in their own context "
-"(scope). This means that when launched, the user enters an interactive session "
-"where all the functionality you've implemented is available."
+"Argenta is designed for creating applications that work in their own "
+"context (scope). This means that the application starts once and creates "
+"an interactive session, similar to Python REPL or MySQL console. When "
+"launched, the user enters this session where all the functionality you've "
+"implemented is available."
 
 #: ../../index.rst:22
 msgid ""
 "Один из ключевых принципов библиотеки — цикличность. После выполнения "
-"команды пользователь остаётся в интерактивной сессии, в отличие от таких "
-"библиотек, как ``argparse``, ``click`` и ``typer``. Выход из сессии "
-"контролируется пользователем."
+"команды пользователь остаётся в интерактивной сессии и может выполнять "
+"следующие команды, в отличие от таких библиотек, как ``argparse``, "
+"``click`` и ``typer``, где приложение завершается после каждой команды. "
+"Выход из сессии контролируется пользователем."
 msgstr ""
-"One of the key principles of the library is cyclicity. After executing a command, "
-"the user remains in the interactive session, unlike libraries such as ``argparse``, "
-"``click``, and ``typer``. Exiting the session is controlled by the user."
+"One of the key principles of the library is cyclicity. After executing a "
+"command, the user remains in the interactive session and can execute "
+"subsequent commands, unlike libraries such as ``argparse``, ``click``, "
+"and ``typer``, where the application terminates after each command. "
+"Exiting the session is controlled by the user."
 
 #: ../../index.rst:24
 msgid "**Ключевые особенности:**"
@@ -103,28 +112,32 @@ msgid ""
 "``Argenta`` создаёт циклические сессии, позволяя пользователю выполнять "
 "команды последовательно, не перезапуская приложение."
 msgstr ""
-"**Interactive sessions**: Unlike traditional CLI tools, ``Argenta`` creates "
-"cyclical sessions, allowing users to execute commands sequentially without "
-"restarting the application."
+"**Interactive sessions**: Unlike traditional CLI tools, ``Argenta`` "
+"creates cyclical sessions, allowing users to execute commands "
+"sequentially without restarting the application."
 
 #: ../../index.rst:27
 msgid ""
 "**Декларативный синтаксис**: Команды и их обработчики объявляются с "
-"помощью простых декораторов, что делает код чистым и интуитивно понятным."
+"помощью простых декораторов, что делает код интуитивно понятным и "
+"позволяет сосредоточиться на том, \"что\" вы хотите сделать, а не "
+"\"как\"."
 msgstr ""
-"**Declarative syntax**: Commands and their handlers are declared using simple "
-"decorators, making the code clean and intuitive."
+"**Declarative syntax**: Commands and their handlers are declared using "
+"simple decorators, making the code intuitive and allowing you to focus "
+"on \"what\" you want to do, not \"how\"."
 
 #: ../../index.rst:28
 msgid ""
-"**Нативный DI**: Благодаря интеграции с `dishka "
-"<https://dishka.readthedocs.io/en/stable/>`_, вы можете легко внедрять "
-"зависимости прямо в обработчики команд, что упрощает их тестирование и "
-"переиспользование."
+"**Нативный DI**: Благодаря интеграции с "
+"[dishka](https://dishka.readthedocs.io/en/stable/), вы можете легко "
+"внедрять зависимости прямо в обработчики команд, что упрощает их "
+"тестирование, позволяет избежать мутабельных глобалов и многое другое."
 msgstr ""
 "**Native DI**: Thanks to integration with `dishka "
 "<https://dishka.readthedocs.io/en/stable/>`_, you can easily inject "
-"dependencies directly into command handlers, simplifying their testing and reuse."
+"dependencies directly into command handlers, simplifying their testing, "
+"avoiding mutable globals, and much more."
 
 #: ../../index.rst:29
 msgid ""
@@ -132,16 +145,19 @@ msgid ""
 "обработку флагов и аргументов командной строки, включая их парсинг, "
 "валидацию и преобразование типов."
 msgstr ""
-"**Automatic validation and parsing**: The library handles command-line flags "
-"and arguments, including their parsing, validation, and type conversion."
+"**Automatic validation and parsing**: The library handles command-line "
+"flags and arguments, including their parsing, validation, and type "
+"conversion."
 
 #: ../../index.rst:30
 msgid ""
 "**Гибкая настройка**: Вы можете легко кастомизировать системные "
-"сообщения, форматирование вывода и т.д."
+"сообщения, форматирование вывода, создавать кастомные обработчики "
+"нестандартного поведения и т.д."
 msgstr ""
 "**Flexible configuration**: You can easily customize system messages, "
-"output formatting, and more."
+"output formatting, create custom handlers for non-standard behavior, "
+"and more."
 
 #: ../../index.rst:35
 msgid "Архитектура и жизненный цикл"
@@ -152,8 +168,8 @@ msgid ""
 "Следующая диаграмма иллюстрирует, как компоненты Argenta взаимодействуют "
 "друг с другом, обрабатывая ввод пользователя."
 msgstr ""
-"The following diagram illustrates how Argenta components interact with each "
-"other while processing user input."
+"The following diagram illustrates how Argenta components interact with "
+"each other while processing user input."
 
 #: ../../index.rst:39
 msgid "Request Lifecycle Diagram"