docs

docs/root/api/app/index.rst

@@ -30,7 +30,7 @@ App
                 system_router_title: str | None = "System points:", 
                 ignore_command_register: bool = True, 
                 dividing_line: AVAILABLE_DIVIDING_LINES = DEFAULT_DIVIDING_LINE, 
-                repeat_command_groups: bool = True, 
+                repeat_command_groups_printing: bool = True, 
                 override_system_messages: bool = False, 
                 autocompleter: AutoCompleter = DEFAULT_AUTOCOMPLETER, 
                 print_func: Printer = DEFAULT_PRINT_FUNC) -> None
@@ -40,14 +40,14 @@ App
     * ``prompt``: Приглашение к вводу, отображаемое перед каждой командой.
     * ``initial_message``: Сообщение, выводимое при запуске приложения.
     * ``farewell_message``: Сообщение, выводимое при выходе из приложения.
-    * ``exit_command``: Команда, используемая для выхода из приложения.
+    * ``exit_command``: Команда, которая маркируется как триггер для выхода из приложения.
     * ``system_router_title``: Заголовок для системного роутера (содержит команду выхода).
-    * ``ignore_command_register``: Если ``True``, регистр команд игнорируется при поиске обработчика.
-    * ``dividing_line``: Стиль разделительной линии (``StaticDividingLine`` или ``DynamicDividingLine``).
-    * ``repeat_command_groups``: Если ``True``, список доступных команд выводится перед каждым вводом.
+    * ``ignore_command_register``: Если ``True``, регистр вводимых команд игнорируется при поиске обработчика.
+    * ``dividing_line``: Тип разделительной линии (``StaticDividingLine`` или ``DynamicDividingLine``).
+    * ``repeat_command_groups_printing``: Если ``True``, список доступных команд выводится перед каждым вводом.
     * ``override_system_messages``: Если ``True``, стандартное форматирование (цвета, ASCII-арт) отключается.
-    * ``autocompleter``: Объект, отвечающий за автодополнение команд.
-    * ``print_func``: Функция для вывода всех системных сообщений (по умолчанию ``rich.print``).
+    * ``autocompleter``: Экземпляр класса :ref:`AutoCompleter <root_api_app_autocompleter>`, отвечающий за автодополнение команд.
+    * ``print_func``: Функция для вывода всех системных сообщений (по умолчанию ``rich.Console().print``).
 
 -----
     
@@ -68,7 +68,7 @@ App
 
 - .. py:method:: add_message_on_startup(self, message: str) -> None
 
-    Добавляет текстовое сообщение, которое выводится при запуске приложения после `initial_message`.
+    Добавляет текстовое сообщение, которое выводится при запуске приложения после ``initial_message``.
 
     :param message: Строка с сообщением.
 
@@ -89,7 +89,7 @@ App
 
 .. py:method:: set_description_message_pattern(self, handler: Callable[[str, str], str]) -> None
 
-   Устанавливает шаблон для форматирования строки описания команды.
+   Устанавливает шаблон для форматирования описания команды.
    
    Обработчик принимает триггер команды (``str``) и её описание (``str``), а возвращает отформатированную строку.
    

docs/root/api/index.rst

@@ -27,14 +27,12 @@
 
 .. code-block:: python
 
-   from argenta import (
-       App, Orchestrator, Router, Command, Response
-   )
+   from argenta import App, Orchestrator, Router, Command, Response
 
-* :ref:`App <root_api_app_index>` — Основной класс приложения.
-* :ref:`Orchestrator <root_api_orchestrator_index>` — Класс для управления жизненным циклом.
+* :ref:`App <root_api_app_index>` — Объект приложения, который отвечает за логику роутинга, настройки, валидации и т.д.
+* :ref:`Orchestrator <root_api_orchestrator_index>` — Класс для конфигурирования и запуска всего приложения.
 * :ref:`Router <root_api_router>` — Класс для группировки и регистрации команд.
-* :ref:`Command <root_api_command_index>` — Класс для создания команд.
+* :ref:`Command <root_api_command_index>` — Класс для создания команд при инициализации хэндлеров.
 * :ref:`Response <root_api_response>` — Объект ответа, передаваемый в обработчики.
 
 .. rubric:: Команды и флаги
@@ -55,9 +53,9 @@
 * :ref:`Flags <root_api_command_flags>` — Коллекция для регистрации флагов.
 * :ref:`InputFlag <root_api_command_input_flag>` — Класс для введённого пользователем флага.
 * :ref:`InputFlags <root_api_command_input_flags>` — Коллекция введённых флагов.
-* :ref:`PossibleValues <root_api_command_possible_values>` — Правила валидации значений флагов.
+* :ref:`PossibleValues <root_api_command_possible_values>` — Правила валидации значений флага.
 * :ref:`ValidationStatus <root_api_command_validation_status>` — Статусы валидации флагов.
-* ``PredefinedFlags`` — Готовые наборы флагов (например, ``--help``).
+* :ref:`PredefinedFlags <root_api_command_flag_predefined_flags>` — Коллекция предопределённых флагов.
 
 .. rubric:: Настройка приложения
 
@@ -70,10 +68,10 @@
        PredefinedMessages
    )
 
-* :ref:`AutoCompleter <root_api_app_autocompleter>` — Базовый класс для автодополнения.
-* :ref:`StaticDividingLine <root_api_app_dividing_lines>` — Статическая разделительная линия.
-* :ref:`DynamicDividingLine <root_api_app_dividing_lines>` — Динамическая разделительная линия.
-* ``PredefinedMessages`` — Готовые системные сообщения.
+* :ref:`AutoCompleter <root_api_app_autocompleter>` - Класс для настройки автодополнения.
+* :ref:`StaticDividingLine <root_api_app_dividing_lines>` — Статическая разделительная линия для оформления вывода.
+* :ref:`DynamicDividingLine <root_api_app_dividing_lines>` — Динамическая разделительная линия для оформления вывода.
+* :ref:`PredefinedMessages <root_api_predefined_messages>` — Готовые сообщения для вывода при старте приложения.
 
 .. rubric:: Внедрение зависимостей
 
@@ -84,8 +82,8 @@
        inject
    )
 
-* :ref:`FromDishka <root_dependency_injection>` — Маркер для внедрения зависимостей.
-* :ref:`inject <root_dependency_injection>` — Декоратор для асинхронного внедрения.
+* :ref:`FromDishka <root_dependency_injection>` — Маркер аргумента функции как зависимости, которая должна быть инжектирована.
+* :ref:`inject <root_dependency_injection>` — Декоратор для инжектирования зависимостей, указанных в сигнатуре.
 
 
 .. toctree::