Документация

Единое пространство для идей, черновиков и первых версий документаций, которые ещё формируются и постепенно становятся самостоятельными материалами.

Проект собирает рабочие документации, стандарты и LLM-артефакты в одном месте, чтобы не создавать отдельное пространство для каждого материала на ранней стадии.

Что внутри

• React/Vite-лендинг со списком документаций.
• VitePress-сборка для SLM Design.
• VitePress-сборка для NextJS Style Guide.
• VitePress-сборка для Figma Adaptive Standards.
• Корневой llms.txt как карта всех документаций.
• Собственные llms.txt и llms-full.txt внутри каждой документации.
• Docker/Caddy-конфигурация для публикации статической сборки.
• Gitea CI/CD для ветки master.

Документации

• SLM Design — архитектура frontend-приложений через слои, модули, публичные API и DI через фабрики.
• NextJS Style Guide — практический стайлгайд для разработки frontend-приложений на Next.js и TypeScript.
• React Style Guide — будущие правила написания React-кода.
• Figma Adaptive Standards — стандарты подготовки адаптивных макетов в Figma.

Структура

canons/                 исходные материалы и черновики
docs/slm-design/        VitePress-сайт SLM Design
docs/nextjs-style-guide/ VitePress-сайт NextJS Style Guide
docs/figma-adaptive-standards/ VitePress-сайт Figma Adaptive Standards
scripts/docs/           подготовка контента для документаций
scripts/site/           генерация корневых артефактов сайта
src/                    React-лендинг
public/                 статические файлы и сгенерированные документации

Команды

npm ci
npm run dev

npm run docs:build:slm-design
npm run docs:build:nextjs-style-guide
npm run docs:build:figma-adaptive-standards
npm run site:generate
npm run build

Основные скрипты:

• npm run dev — запускает Vite dev server.
• npm run docs:build:slm-design — подготавливает и собирает VitePress-документацию SLM Design.
• npm run docs:build:nextjs-style-guide — подготавливает и собирает VitePress-документацию NextJS Style Guide.
• npm run docs:build:figma-adaptive-standards — подготавливает и собирает VitePress-документацию Figma Adaptive Standards.
• npm run site:generate — генерирует корневой public/llms.txt из src/config/docs.config.ts и хардкод-секций.
• npm run build — генерирует корневые артефакты и собирает лендинг.
• npm run lint — запускает ESLint.

LLM-артефакты

Корневой файл:

/llms.txt

Он является навигационной картой пространства документаций и указывает на llms.txt конкретных материалов.

Пример проектных артефактов:

/slm-design/llms.txt
/slm-design/llms-full.txt
/nextjs-style-guide/llms.txt
/nextjs-style-guide/llms-full.txt
/figma-adaptive-standards/llms.txt
/figma-adaptive-standards/llms-full.txt

Корневой llms-full.txt намеренно не создаётся. Полные bundles остаются внутри конкретных документаций.

Caddy

Caddyfile отдаёт статическую сборку из /srv, поддерживает clean URLs и выставляет контекстные Link headers:

• /slm-design/* → /slm-design/llms.txt
• /nextjs-style-guide/* → /nextjs-style-guide/llms.txt
• /react-style-guide/* → /react-style-guide/llms.txt
• /figma-adaptive-standards/* → /figma-adaptive-standards/llms.txt
• остальные пути → /llms.txt

Редиректов llms.txt в корень нет.

Docker

Локальная проверка образа:

docker build -t all-docs:test .

Docker-сборка выполняет:

npm run docs:build:slm-design
npm run docs:build:nextjs-style-guide
npm run docs:build:figma-adaptive-standards
npm run build

CI/CD

Workflow находится в .gitea/workflows/ci.yml.

Особенности:

• запускается только для ветки master;
• не создаёт версии и теги;
• собирает документацию, лендинг и Docker-образ;
• деплоит контейнер docs в Docker network web.