docs: MAN format fix history + instructions (??? admonition, not details/div)

docs/LLM_DOCS_GENERATION.md

@@ -31,7 +31,7 @@ S3 (terraform-registry) ── хостинг через registry.kube5s.ru  <!-
 
 | Файл | Содержание |
 |---|---|
-| `Name.md` | Главная: MAN (переведён в Markdown), навигация |
+| `Name.md` | Главная: краткое описание + MAN в `??? note` (mkdocs-native admonition) |
 | `Name_example.md` | HCL-пример с полным манифестом |
 | `Name_params_create.md` | Таблицы Create-параметров + вложенные sub_params |
 | `Name_params_modify.md` | Таблицы Modify-параметров |
@@ -41,6 +41,51 @@ S3 (terraform-registry) ── хостинг через registry.kube5s.ru  <!-
 | `Name_subresource.md` | Для каждого subresource: параметры |
 | `Name_subresource_example.md` | HCL-пример subresource |
 
+## Формат MAN (service_man) — как рендерится
+
+`service_man` из YAML содержит **смесь Markdown и HTML**: заголовки `#`/`##`, списки `-`, bold `**`, горизонтальные линии `---`, а также `<br/>` и HTML-entities.
+
+### Конвертация: `htmlToMarkdown()`
+
+```go
+// 1. <br/> → \n
+// 2. <h1>/<h2>/<h3> → # / ## / ###
+// 3. <strong>/<b> → **...**
+// 4. <em>/<i> → *...*
+// 5. <code> → `...`
+// 6. <a href> → [...](...)
+// 7. <ul><li> → - ...
+// 8. Strip remaining HTML tags
+// 9. Unescape HTML entities (&quot; → ")
+// 10. Collapse 3+ blank lines → 2
+```
+
+### Рендеринг: `??? note` admonition (НЕ `<details>`!)
+
+**Важно:** `<details>` и `<div markdown="1">` НЕ работают в mkdocs — Markdown внутри них не рендерится.
+
+Вместо этого используется **нативный mkdocs admonition** `??? note`:
+
+```markdown
+??? note "Справка (MAN)"
+
+    # Инструкция по развертыванию
+    
+    ---
+    ## 1. Общая информация
+    Текст параграфа.
+    
+    - **bold** — описание
+    - `code` — пример
+```
+
+**Критические требования:**
+1. Пустая строка после `??? note "..."` — обязательно
+2. Все строки контента с отступом ровно 4 пробела — включая пустые
+3. `pymdownx.details` в `markdown_extensions` (уже есть)
+
+Результат: `<details class="note"><summary>Справка (MAN)</summary><h1>...</h1><hr/><h2>...</h2>...</details>`
+
 ## Принципы дизайна (CSS)
 
 - `max-width: 1800px` — лёгкое ограничение (на 2560px поля ~380px)