docs(usage): add platform overview, licensing, admin guide and support lifecycle pages

- Add platform-overview, licensing, admin-guide, support-lifecycle
  documentation in English and Russian
- Add build_docs.sh script to build docs artifacts via tox
- Register exordos_docs manifest and artifact in exordos.yaml
- Update mkdocs.yml navigation with new usage sections

Signed-off-by: Anton Kremenetsky <anton.kremenetsky@gmail.com>

Author: akremenetsky

docs/app-developer-guide/index.md docs/app-developer-guide/app-guide.mddocs/app-developer-guide/index.md renamed to docs/app-developer-guide/app-guide.md

@@ -1,4 +1,5 @@
 ---
+icon: lucide/package-open
 title: Application Developer Guide
 ---
 

docs/app-developer-guide/index.ru.md docs/app-developer-guide/app-guide.ru.mddocs/app-developer-guide/index.ru.md renamed to docs/app-developer-guide/app-guide.ru.md

@@ -1,4 +1,5 @@
 ---
+icon: lucide/package-open
 title: Руководство для разработчиков приложений
 ---
 
@@ -16,7 +17,7 @@ exordos init
 
 После завершения работы мастера ваш проект будет содержать необходимые конфигурационные файлы — включая манифесты — которые описывают ваш элемент для платформы.
 
-[Подробнее →](init.ru.md)
+[Подробнее →](init.md)
 
 ---
 
@@ -30,7 +31,7 @@ exordos build
 
 При успехе результат сборки (образ контейнера, бинарный файл или другой тип артефакта) сохраняется локально и помечается текущей версией элемента.
 
-[Подробнее →](build.ru.md)
+[Подробнее →](build.md)
 
 ---
 
@@ -44,7 +45,7 @@ exordos push
 
 Элемент версионируется и отправляется в настроенный репозиторий на основе метаданных в `exordos.yaml`.
 
-[Подробнее →](push.ru.md)
+[Подробнее →](push.md)
 
 ---
 
@@ -58,7 +59,7 @@ exordos elements install <element-name>
 
 Платформа разрешает зависимости, устанавливает целевой элемент и запускает его в выбранном окружении.
 
-[Подробнее →](deploy.ru.md)
+[Подробнее →](deploy.md)
 
 ---
 
@@ -75,7 +76,7 @@ exordos elements install <element-name>
 **Exordos** — вы можете использовать:
 
 - **Публичную установку Exordos** — размещённую на [exordos.com](https://exordos.com). Не требуется настройка; просто создайте аккаунт и начните использовать платформу.
-- **Приватную установку Exordos** — ваш собственный self-hosted экземпляр. Этот документ описывает, как его настроить: [Локальное развёртывание](../usage/local_deployment.ru.md).
+- **Приватную установку Exordos** — ваш собственный self-hosted экземпляр. Этот документ описывает, как его настроить: [Локальное развёртывание](../usage/local_deployment.md).
 
 Установите необходимые инструменты ниже.
 
@@ -159,6 +160,6 @@ ToDo API теперь доступен по настроенной конечн
 
 Когда вы освоитесь с основами, изучите более углублённые темы ниже.
 
-- [Написание манифеста с нуля](../em/manifest.ru.md) — изучите полную спецификацию манифеста и создайте его вручную без помощи мастера `exordos init`.
-- [Настройка приватной установки платформы](../usage/local_deployment.ru.md) — разверните собственный экземпляр Exordos Core для разработки и тестирования ваших элементов end-to-end без подключения к удалённому окружению.
+- [Написание манифеста с нуля](../em/manifest.md) — изучите полную спецификацию манифеста и создайте его вручную без помощи мастера `exordos init`.
+- [Настройка приватной установки платформы](../usage/local_deployment.md) — разверните собственный экземпляр Exordos Core для разработки и тестирования ваших элементов end-to-end без подключения к удалённому окружению.
 - [Публичная установка Exordos](https://exordos.com) — используйте размещённую Exordos-платформу без управления собственной инфраструктурой.

docs/app-developer-guide/build.ru.md

@@ -222,7 +222,7 @@ fi
 exordos build --manifest-var environment=production --manifest-var region=europe-east .
 ```
 
-[Полный справочник по манифестам →](../em/manifest.ru.md)
+[Полный справочник по манифестам →](../em/manifest.md)
 
 ---
 
@@ -259,11 +259,11 @@ output/
 
 После успешной сборки ваши элементы готовы для:
 
-- [`exordos push`](push.ru.md) — публикация в реестр экосистемы
-- [`exordos deploy`](deploy.ru.md) — развёртывание в установку Exordos
+- [`exordos push`](push.md) — публикация в реестр экосистемы
+- [`exordos deploy`](deploy.md) — развёртывание в установку Exordos
 
 ---
 
 ## Устранение неполадок
 
-Если вы столкнулись с проблемами в процессе сборки — такими как ошибки разрешения зависимостей, ошибки сборки образов VM или проблемы обработки манифестов — обратитесь к [Руководству по устранению неполадок](../usage/troubleshooting.ru.md) для подробных решений и типичных исправлений.
+Если вы столкнулись с проблемами в процессе сборки — такими как ошибки разрешения зависимостей, ошибки сборки образов VM или проблемы обработки манифестов — обратитесь к [Руководству по устранению неполадок](../usage/troubleshooting.md) для подробных решений и типичных исправлений.

docs/app-developer-guide/deploy.ru.md

@@ -17,7 +17,7 @@ exordos elements install [OPTIONS] PATH_OR_NAME
 | `-r, --repository TEXT` | Конечная точка репозитория, где хранится элемент [по умолчанию](https://repo.exordos.com/exordos-elements/) |
 | `PATH_OR_NAME`          | Путь к локальному файлу манифеста или имя элемента в репозитории                                            |
 
-Вы можете устанавливать элементы на [публичную установку Exordos Core](../usage/public-installation.ru.md). Или вы можете развернуть [приватную установку Exordos Core](../usage/private-installation.ru.md) на своём оборудовании. Для разработки и тестирования вы можете использовать [установку на локальном ноутбуке](../usage/local_deployment.ru.md).
+Вы можете устанавливать элементы на [публичную установку Exordos Core](../usage/public-installation.md). Или вы можете развернуть [приватную установку Exordos Core](../usage/private-installation.md) на своём оборудовании. Для разработки и тестирования вы можете использовать [установку на локальном ноутбуке](../usage/local_deployment.md).
 
 ---
 
@@ -72,11 +72,11 @@ exordos elements install -r https://my-repo.example.com/elements/ my-element
 После успешной установки:
 
 - Проверьте статус элемента в Exordos Core CLI
-- [Настройте манифест](../em/manifest.ru.md) для адаптации конфигурации элемента под ваши нужды
-- [Обновите элемент](../usage/admin-guide.ru.md) когда доступна новая версия
+- [Настройте манифест](../em/manifest.md) для адаптации конфигурации элемента под ваши нужды
+- [Обновите элемент](../usage/admin-guide.md) когда доступна новая версия
 
 ---
 
 ## Устранение неполадок
 
-Если вы столкнулись с проблемами во время развёртывания — такими как ошибки установки элемента, ошибки разрешения зависимостей или проблемы подключения к realm — обратитесь к [Руководству по устранению неполадок](../usage/troubleshooting.ru.md) для подробных решений и типичных исправлений.
+Если вы столкнулись с проблемами во время развёртывания — такими как ошибки установки элемента, ошибки разрешения зависимостей или проблемы подключения к realm — обратитесь к [Руководству по устранению неполадок](../usage/troubleshooting.md) для подробных решений и типичных исправлений.

docs/app-developer-guide/init.ru.md

@@ -32,7 +32,7 @@ exordos init [OPTIONS]
 
 `exordos init` работает как **интерактивный мастер** — он проводит вас через серию вопросов и принимает решения на основе ваших ответов. Вам не нужно знать опции заранее; мастер адаптирует свои вопросы в зависимости от выбранного типа проекта.
 
-[Подробнее о мастере →](../usage/wizard.ru.md)
+[Подробнее о мастере →](../usage/wizard.md)
 
 ---
 
@@ -64,7 +64,7 @@ exordos init [OPTIONS]
 
 Сгенерированный манифест — это отправная точка. Вы можете отредактировать его вручную в любое время.
 
-[Полный справочник по манифестам →](../em/manifest.ru.md)
+[Полный справочник по манифестам →](../em/manifest.md)
 
 ---
 
@@ -85,4 +85,4 @@ exordos init [OPTIONS]
 
 ## Устранение неполадок
 
-Если вы столкнулись с проблемами во время инициализации — такими как ошибки определения типа проекта, ошибки генерации манифеста или проблемы конфигурации CI/CD — обратитесь к [Руководству по устранению неполадок](../usage/troubleshooting.ru.md) для подробных решений и типичных исправлений.
+Если вы столкнулись с проблемами во время инициализации — такими как ошибки определения типа проекта, ошибки генерации манифеста или проблемы конфигурации CI/CD — обратитесь к [Руководству по устранению неполадок](../usage/troubleshooting.md) для подробных решений и типичных исправлений.

docs/app-developer-guide/push.ru.md

@@ -22,7 +22,7 @@ exordos push [OPTIONS] [PROJECT_DIR]
 | `-f, --force` | Принудительная отправка, даже если элемент уже существует |
 | `-l, --latest` | Также отправить элемент как версию `latest` (для стабильных версий) |
 
-Вы можете отправлять элементы в [публичный репозиторий Exordos Core](../usage/public-installation.ru.md). Или вы можете развернуть [приватную установку Exordos Core](../usage/private-installation.ru.md) на своём оборудовании. Для разработки и тестирования вы можете использовать [установку на локальном ноутбуке](../usage/local-laptop-installation.ru.md).
+Вы можете отправлять элементы в [публичный репозиторий Exordos Core](../usage/public-installation.md). Или вы можете развернуть [приватную установку Exordos Core](../usage/private-installation.md) на своём оборудовании. Для разработки и тестирования вы можете использовать [установку на локальном ноутбуке](../usage/local-laptop-installation.md).
 
 ---
 
@@ -118,11 +118,11 @@ exordos push -c exordos.push.yaml
 
 После успешной отправки ваш элемент доступен в реестре и готов для:
 
-- [`exordos deploy`](deploy.ru.md) — развёртывание элемента в установку Exordos
+- [`exordos deploy`](deploy.md) — развёртывание элемента в установку Exordos
 - Совместного использования с другими разработчиками в вашей организации
 
 ---
 
 ## Устранение неполадок
 
-Если вы столкнулись с проблемами при отправке элементов — такими как ошибки подключения к репозиторию, ошибки аутентификации или проблемы загрузки — обратитесь к [Руководству по устранению неполадок](../usage/troubleshooting.ru.md) для подробных решений и типичных исправлений.
+Если вы столкнулись с проблемами при отправке элементов — такими как ошибки подключения к репозиторию, ошибки аутентификации или проблемы загрузки — обратитесь к [Руководству по устранению неполадок](../usage/troubleshooting.md) для подробных решений и типичных исправлений.

docs/core-developer-guide/index.md docs/core-developer-guide/core-guide.mddocs/core-developer-guide/index.md renamed to docs/core-developer-guide/core-guide.md

@@ -1,11 +1,12 @@
 ---
+icon: lucide/cpu
 title: Core Developer Guide
 ---
 
 This guide describes the internal architecture of Exordos Core: how elements, manifests, and resources are
 stored and reconciled onto compute nodes. It's aimed at people working on Exordos Core itself. If you want
 to build an element on top of the platform instead, see the
-[Application Developer Guide](../app-developer-guide/index.md).
+[Application Developer Guide](../app-developer-guide/app-guide.md).
 
 ## Elements, manifests, and resources
 

docs/core-developer-guide/index.ru.md …cs/core-developer-guide/core-guide.ru.mddocs/core-developer-guide/index.ru.md renamed to docs/core-developer-guide/core-guide.ru.md docs/core-developer-guide/index.ru.md renamed to docs/core-developer-guide/core-guide.ru.md

@@ -1,11 +1,12 @@
 ---
+icon: lucide/cpu
 title: Руководство для разработчиков ядра
 ---
 
 Это руководство описывает внутреннюю архитектуру Exordos Core: как элементы, манифесты и ресурсы
 хранятся и приводятся в соответствие (reconcile) на вычислительных нодах. Оно предназначено для тех, кто
 работает над самим Exordos Core. Если вы хотите разработать элемент поверх платформы, см.
-[Руководство для разработчиков приложений](../app-developer-guide/index.ru.md).
+[Руководство для разработчиков приложений](../app-developer-guide/app-guide.md).
 
 ## Элементы, манифесты и ресурсы
 
@@ -64,7 +65,7 @@ Reconciliation выполняет `ElementManagerBuilder` (`elements/services/bu
 
 Автор манифеста, забывший префикс `f"`, не получает молча пустое значение — буквальный текст `{$...}`
 остаётся в результирующем выводе, где бы это значение ни оказалось (в конфигурационном файле, в командной
-строке сервиса и т.д.). См. [Диагностику проблем](../usage/troubleshooting.ru.md) — там описаны симптомы,
+строке сервиса и т.д.). См. [Диагностику проблем](../usage/troubleshooting.md) — там описаны симптомы,
 к которым это приводит.
 
 ## Основные типы ресурсов ядра
@@ -73,11 +74,11 @@ Reconciliation выполняет `ElementManagerBuilder` (`elements/services/bu
 - `$core.em.services` — systemd-сервисы на ноде или группе нод
 - `$core.vs.variables` — Variable Store, используется для платформенных значений по умолчанию
 - `$core.config.configs` — файлы, доставляемые на ноду; требует `project_id` и `body.kind`, см.
-  [Диагностику проблем](../usage/troubleshooting.ru.md)
+  [Диагностику проблем](../usage/troubleshooting.md)
 
 ## См. также
 
-- [Справочник по манифесту](../em/manifest.ru.md)
+- [Справочник по манифесту](../em/manifest.md)
 - [Service as a Service API](../em/service.md)
-- [Repo Proxy](./repo-proxy.ru.md)
-- [Диагностика проблем](../usage/troubleshooting.ru.md)
+- [Repo Proxy](./repo-proxy.md)
+- [Диагностика проблем](../usage/troubleshooting.md)

docs/core-developer-guide/repo-proxy.md

@@ -1,4 +1,5 @@
 ---
+icon: lucide/git-fork
 title: Repo Proxy
 ---
 
@@ -540,6 +541,6 @@ graph TB
 
 ## See also
 
-- [Core Developer Guide](index.md) — architecture overview, element engine, reconciliation
+- [Core Developer Guide](core-guide.md) — architecture overview, element engine, reconciliation
 - [Exports reference](exports.md) — how elements share resources
 - [Manifest reference](../em/manifest.md) — manifest YAML specification

docs/core-developer-guide/repo-proxy.ru.md

@@ -1,4 +1,5 @@
 ---
+icon: lucide/git-fork
 title: Repo Proxy
 ---
 
@@ -243,7 +244,7 @@ class AbstractProxyRepoDriver(abc.ABC):
   перебирает инвентарь и сохраняет элементы. В режиме `copy` каждый элемент
   актуализируется (полная загрузка данных). В режиме `lazy` сохраняется только
   имя/версия. Устанавливает статус `ACTIVE` и планирует `next_refresh`.
-- **`_check_refresh`** — запускается каждые 10 итераций
+- **`refresh`** — запускается каждые 10 итераций
   (`REFRESH_CHECK_ITERATION_INTERVAL`). Для каждого репозитория, у которого
   `next_refresh` прошёл, вызывает `repo.update(force=True)` для запуска хука
   обновления.
@@ -544,5 +545,5 @@ graph TB
 
 ## См. также
 
-- [Руководство для разработчиков ядра](index.ru.md) — обзор архитектуры, element engine, reconciliation
-- [Справочник по манифесту](../em/manifest.ru.md) — спецификация YAML-манифеста
+- [Руководство для разработчиков ядра](core-guide.md) — обзор архитектуры, element engine, reconciliation
+- [Справочник по манифесту](../em/manifest.md) — спецификация YAML-манифеста