docs

docs/conf.py

@@ -17,10 +17,6 @@ root_doc = "index"
 locale_dirs = ['locales/']
 gettext_compact = False
 
-extensions = [
-    "sphinx.ext.graphviz"
-]
-
 templates_path = ["_templates"]
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 

docs/index.rst

@@ -32,7 +32,8 @@ Argenta предназначена для создания приложений,
 Следующая диаграмма иллюстрирует, как компоненты Argenta взаимодействуют друг с другом, обрабатывая ввод пользователя.
 
 .. image:: https://i.ibb.co/hF3FdFr1/argenta-intro-drawio-2.png
-    :alt: Архитектура Argenta
+   :alt: Request Lifecycle Diagram
+   :align: center
 
 .. toctree::
     :hidden:

docs/root/api/app/index.rst

@@ -72,6 +72,9 @@ App
 
     :param message: Строка с сообщением.
 
+    .. seealso::
+       Для вывода стандартных сообщений можно использовать готовые шаблоны из :ref:`PredefinedMessages <root_api_predefined_messages>`.
+    
 -----
 
 Методы установки обработчиков
@@ -135,3 +138,42 @@ App
 
     autocompleter
     dividing_lines
+
+-----
+
+.. _root_api_predefined_messages:
+
+PredefinedMessages
+------------------
+
+`PredefinedMessages` — это перечисление (Enum), содержащее набор готовых к использованию строковых сообщений. Они отформатированы с использованием синтаксиса `rich` и предназначены для вывода стандартной информации, такой как подсказки по использованию.
+
+Вы можете импортировать и использовать их напрямую в своих обработчиках.
+
+.. code-block:: python
+   :linenos:
+
+   from argenta.app import PredefinedMessages
+
+   def my_handler(response):
+       print(PredefinedMessages.USAGE)
+
+.. py:class:: PredefinedMessages
+
+   .. py:attribute:: USAGE
+
+      Строка: ``[b dim]Usage[/b dim]: [i]<command> <[green]flags[/green]>[/i]``
+
+      Отображается как: ``Usage: <command> <flags>``
+
+   .. py:attribute:: HELP
+
+      Строка: ``[b dim]Help[/b dim]: [i]<command>[/i] [b red]--help[/b red]``
+
+      Отображается как: ``Help: <command> --help``
+
+   .. py:attribute:: AUTOCOMPLETE
+
+      Строка: ``[b dim]Autocomplete[/b dim]: [i]<part>[/i] [bold]<tab>``
+
+      Отображается как: ``Autocomplete: <part> <tab>``

docs/root/api/index.rst

@@ -96,4 +96,3 @@
     orchestrator/index
     command/index
     response
-    

docs/root/flags.rst

@@ -37,8 +37,6 @@
 
 Вы можете заранее определить список допустимых значений для флага.
 
-**Пример:**
-
 Предположим, у вас есть флаг ``--format``, который может принимать только значения ``json`` или ``xml``.
 
 .. code-block:: bash
@@ -57,8 +55,6 @@
 
 Для более сложных проверок можно использовать регулярные выражения. Это полезно, когда значение должно соответствовать определённому формату (например, email-адрес, дата или номер телефона).
 
-**Пример:**
-
 Допустим, флаг ``--email`` должен принимать только корректные email-адреса.
 
 .. code-block:: bash