Публикация и доставка знаний¶
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 задаёт процесс превращения утверждённого знания в доступное представление.
Поэтому в навигации эти три контейнера расположены рядом, но не объединены в одну сущность.