Skip to content

Публикация и доставка знаний

Knowledge Delivery — путь канонического знания от документа-источника к доступному, проверяемому и датированному представлению для человека или агента. Это не серверная инфраструктура вообще и не доставка продукта пользователю.

Цепочка доставки

решение или знание
→ канонический Markdown и metadata
→ проверка структуры, ссылок и статуса
→ сборка MkDocs и поискового индекса
→ языковые и публичные представления
→ версия или release snapshot
→ использование человеком или агентом
→ обнаруженное расхождение
→ обновление источника истины

Что входит

  • правила перехода документа из draft в действующий статус;
  • сборка и проверка документационного сайта;
  • навигация, поиск, индексирование и стабильные связи;
  • языковые версии и управление расхождениями между ними;
  • публикация канонической версии и release notes;
  • представления metadata для людей и машин;
  • маршруты от основного сайта, книги и агентов к документации;
  • наблюдение за broken links, устареванием и неясными ответами.

Что не входит

  • серверы, сети, secrets, backups и общая эксплуатационная инфраструктура;
  • CI/CD и выпуск кода продукта как целое;
  • customer onboarding и доставка пользовательской ценности Platform DETai;
  • ClickUp, GitHub, Codex и другие рабочие инструменты сами по себе.

Эти системы взаимодействуют с Knowledge Delivery, но остаются самостоятельными разделами.

Критерий успешной доставки

Знание считается доставленным, если целевой читатель может найти актуальный ответ, понять его статус и перейти к источнику или следующему действию. Факт публикации страницы без маршрута, версии и владельца этого не гарантирует.

Интерфейс с инфраструктурой и инструментами

  • Инфраструктура даёт среду выполнения, хранение, сеть, доступность и восстановление.
  • Инструменты команды поддерживают создание, review и координацию работы.
  • Knowledge Delivery задаёт процесс превращения утверждённого знания в доступное представление.

Поэтому в навигации эти три контейнера расположены рядом, но не объединены в одну сущность.