Update documentation and code snippets

docs/root/api/orchestrator/argparser.rst

@@ -25,8 +25,10 @@ ArgParser
 * ``description``: Описание приложения для отображения в справке.
 * ``epilog``: Дополнительная информация для отображения в конце справки.
 
+-----
+
 Атрибуты
----------------------------
+--------
 
 .. py:attribute:: parsed_argspace: ArgSpace
 
@@ -39,13 +41,14 @@ ArgParser
 
 -----
    
+-----
+
 Лучшие практики
-------------------------
+---------------
 
 Использовать атрибут ``parsed_argspace`` рекомендуется только на этапе настройки приложения. В обработчиках лучшей практикой является получение ``ArgSpace`` через DI. Подробнее см. :ref:`здесь <root_dependency_injection>`.
 
-Пример использования
---------------------
+**Пример использования:**
 
 .. literalinclude:: ../../../code_snippets/argparser/snippet.py
    :language: python

docs/root/api/orchestrator/argspace.rst

@@ -75,8 +75,8 @@ InputArgument
 
 -----
 
-Примеры испольования
---------------------
+Примеры использования
+---------------------
 
 ``ArgSpace`` используется для доступа к значениям аргументов после запуска приложения. Типичный сценарий включает обработку аргументов через ``ArgParser`` и последующее извлечение значений из ``ArgSpace``.
 
@@ -87,6 +87,8 @@ InputArgument
    
 Доступ к аргументам из обработчиков осуществляется с помощью ``di``. Подробнее см. :ref:`здесь <root_dependency_injection>`.
 
+**Пример использования:**
+
 .. literalinclude:: ../../../code_snippets/argspace/snippet2.py
    :linenos:
 

docs/root/api/orchestrator/arguments.rst

@@ -35,8 +35,8 @@ ValueArgument
 :param help: Сообщение для справки (``--help``)
 :param possible_values: Список допустимых значений 
 :param default: Значение по умолчанию, если аргумент не передан
-:param is_required: Если ``True``, аргумент становится обязательным, если не передать при запуске приложение не запустится
-:param is_deprecated: Если ``True``, помечает аргумент как устаревший, если передать при запуске, то будет выведено предупреждение в консоль
+:param is_required: Если ``True``, аргумент становится обязательным. Если не передать при запуске, приложение не запустится
+:param is_deprecated: Если ``True``, помечает аргумент как устаревший. Если передать при запуске, будет выведено предупреждение в консоль
 
 **Пример использования:**
 
@@ -115,7 +115,7 @@ InputArgument
 Создаёт экземпляр обработанного входного аргумента.
 
 :param name: Имя аргумента
-:param value: Значение аргумента. Для ``BooleanArgument`` — **True**, если аргумент передан и **False**, если нет; для **ValueArgument** — введённая строка 
+:param value: Значение аргумента. Для ``BooleanArgument`` — **True**, если аргумент передан, и **False**, если нет; для ``ValueArgument`` — введённая строка 
 :param founder_class: Класс-родитель, из которого был создан аргумент (``BooleanArgument`` или ``ValueArgument``)
 
 **Атрибуты:**
@@ -128,8 +128,8 @@ InputArgument
 
    Значение аргумента. Тип зависит от исходного класса:
 
-* Для ``BooleanArgument``: **True**, если аргумент был передан.
-* Для ``ValueArgument``: строка с переданным значением или значением по умолчанию
+   * Для ``BooleanArgument``: **True**, если аргумент был передан
+   * Для ``ValueArgument``: строка с переданным значением или значением по умолчанию
 
 .. py:attribute:: founder_class
 

docs/root/api/orchestrator/index.rst

@@ -47,12 +47,11 @@ Orchestrator
 Назначение и использование
 ----------------------------
 
-``Orchestrator`` абстрагирует сложность, связанную с настройкой ``di`` и парсингом стартовых аргументов. Типичный сценарий использования выглядит так.
+``Orchestrator`` абстрагирует сложность, связанную с настройкой ``di`` и парсингом стартовых аргументов.
 
 Такой подход разделяет ответственности: ``App`` отвечает за логику интерактивной сессии, а ``Orchestrator`` — за подготовку окружения и запуск приложения.
 
-Пример использования
---------------------
+**Пример использования:**
 
 .. literalinclude:: ../../../code_snippets/orchestrator/snippet.py
    :language: python