build(docs): скрипт 04 копирует картинки docs/diagrams (*.svg|png) в публикуемый docs_dir; README диаграмм — раздел о публикации

docs/diagrams/README.md

@@ -50,6 +50,19 @@ python3 docs/diagrams/render_infra_diagram.py
 (`/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf`, `...-Bold.ttf`).
 Сторонние библиотеки для SVG не нужны — SVG формируется текстом.
 
+### Публикация картинок на сайте
+
+Скрипт `TOOLS/scripts/04_build_and_publish_docs.sh` копирует **только картинки**
+(`docs/diagrams/*.svg`, `*.png`) в публикуемый `docs_dir` → `diagrams/`: исходники (`.mmd`, `.py`)
+на сайт не попадают. Поэтому картинку можно вставлять в опубликованные страницы относительной
+ссылкой, например со страницы `docs/curated/pipeline/vdc_edge_ip_snat.md`:
+
+```markdown
+![Схема зависимостей облачных сервисов](../../diagrams/infra_services_diagram.svg)
+```
+
+Изменения в `docs/diagrams/` попадают на сайт только при следующей публикации документации.
+
 Для Mermaid-версии нужен рендерер (`mermaid.ink`, `mmdc` или предпросмотр
 Markdown в VS Code); в этом репозитории использовался `mermaid.ink` через
 `python3` + `urllib`.