Generate Sphinx docs in markdown

SRV/services/firewalld_service.py

@@ -2,14 +2,13 @@
 Сервис для управления firewalld через D‑Bus.
 
 Назначение:
-- Обёртка над интерфейсами `org.fedoraproject.FirewallD1` для выполнения
-  типовых операций по зонам: просмотр/изменение дефолтной зоны, добавление и
-  удаление сервисов, портов, источников, перезагрузка конфигурации.
+
+- Обёртка над интерфейсами `org.fedoraproject.FirewallD1` для выполнения типовых операций по зонам: просмотр/изменение дефолтной зоны, добавление и удаление сервисов, портов, источников, перезагрузка конфигурации.
 
 Примечания:
+
 - Используется `pydbus.SystemBus` для доступа к системной шине.
-- Методы генерируют дружелюбные исключения при ошибках, содержащие контекст
-  операции.
+- Методы генерируют дружелюбные исключения при ошибках, содержащие контекст операции.
 """
 from re import DEBUG
 from typing import Dict, List, Optional

SRV/services/ip_service.py

@@ -2,15 +2,14 @@
 Сервис проверки и применения IP‑настроек через NetworkManager (D‑Bus).
 
 Назначение:
-- Перед применением конфигурации проверяет занятость IP адреса, сканируя сегмент
-  сети средствами ARP (через `NetworkScanner`).
-- Применяет изменения профиля подключения через `sdbus_async.networkmanager` и
-  выполняет переподключение интерфейса.
+
+- Перед применением конфигурации проверяет занятость IP адреса, сканируя сегмент сети средствами ARP (через `NetworkScanner`).
+- Применяет изменения профиля подключения через `sdbus_async.networkmanager` и выполняет переподключение интерфейса.
 
 Требования/ограничения:
+
 - Доступ к системной шине D‑Bus и права на изменения сетевых профилей.
-- Структура входных данных должна соответствовать схеме `ipv4_updates` для
-  корректного обновления вложенных полей у профиля.
+- Структура входных данных должна соответствовать схеме `ipv4_updates` для корректного обновления вложенных полей у профиля.
 """
 from typing import Dict, Any
 from sdbus_async.networkmanager import (

SRV/services/network_service.py

@@ -2,14 +2,13 @@
 Сервис чтения сетевого состояния через NetworkManager (D‑Bus).
 
 Назначение:
-- Предоставляет асинхронные методы для сборки унифицированных моделей
-  сетевых интерфейсов (Ethernet/Wi‑Fi), их IP‑конфигураций, а также получения
-  имени хоста. Используется API‑слоем для визуализации и управления.
+
+- Предоставляет асинхронные методы для сборки унифицированных моделей сетевых интерфейсов (Ethernet/Wi‑Fi), их IP‑конфигураций, а также получения имени хоста. Используется API‑слоем для визуализации и управления.
 
 Особенности:
+
 - Фильтрация loopback и явно неактивных интерфейсов.
-- Адаптация данных D‑Bus в pydantic‑модели (`NetworkInterface`, `WiFiDevice`,
-  `NetworkInterfacesContainer`).
+- Адаптация данных D‑Bus в pydantic‑модели (`NetworkInterface`, `WiFiDevice`, `NetworkInterfacesContainer`).
 """
 from typing import List, Dict, Tuple, Union, Optional
 from sdbus_async.networkmanager import (

SRV/services/subnet_service.py

@@ -245,15 +245,16 @@ class DeviceInfoCollector:
 class DeviceStorage:
     """Класс для хранения и управления данными об устройствах.
 
-    Формат файла подсети:
-        JSON‑структура вида
+    Формат файла подсети::
+
         {
           "devices": [Device, ...]
         }
 
     Политика очистки:
-        - Метод `_clean_old_devices` удаляет оффлайн‑устройства, не наблюдавшиеся
-          более 7 дней, чтобы поддерживать актуальность списка.
+
+    - Метод `_clean_old_devices` удаляет оффлайн‑устройства, не наблюдавшиеся более 7 дней,
+      чтобы поддерживать актуальность списка.
     """
     def __init__(self, base_path: str = "storage/subnets", translations: Translations = None):
         """Инициализирует хранилище устройств.