Решение по платформе документации¶
Статус: accepted
Дата: 2026-06-19
Владелец: OpenClaw / Knowledge Operations
Решение: использовать MkDocs Material + Cloudflare Pages + Cloudflare Access
Контекст¶
Нужен Confluence-like портал для документации проектов. Основная аудитория — OpenClaw / operations / leadership. Юристы — важная отдельная аудитория: для них нужен curated слой с инструкциями, FAQ и эскалациями.
Почему MkDocs¶
- Markdown + Git history;
- быстрый статический сайт;
- бесплатный деплой на Cloudflare Pages;
- можно явно контролировать, какие страницы попадают в публикацию;
- удобно строить MCP/AI search поверх curated corpus.
Current deployments¶
| Surface | Cloudflare Pages project | Production URL | Source | Output |
|---|---|---|---|---|
| Internal Docs | openclaw-docs |
https://openclaw-docs-do5.pages.dev |
docs-portal/ + mkdocs.yml |
site-internal |
| Legal Docs | openclaw-docs-legal |
https://openclaw-docs-legal.pages.dev |
docs-legal/ + mkdocs.legal.yml |
site-legal |
Access status: pending Cloudflare Access policy for both production URLs.
Почему не один общий build¶
Legal portal должен быть отдельной физической сборкой, а не просто скрытым разделом в навигации. Если внутренние страницы попадают в output, их можно открыть напрямую даже без пункта меню.