https://valoryx.org/ru/ Recent content in Valoryx — Git-Native Платформа Документации on Valoryx Hugo ru Wed, 10 Jun 2026 00:00:00 +0000 https://valoryx.org/ru/docs/getting-started/quickstart/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/getting-started/quickstart/ Быстрый старт От нуля до работающей платформы документации менее чем за 5 минут. Это руководство описывает самый быстрый путь — для подробных вариантов смотрите руководство по установке. Шаг 1: Установка # Recommended (auto-detects platform) curl -fsSL https://valoryx.org/install.sh | sh Или скачайте вручную: curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform Или с Docker: docker run -d --name docplatform -p 3000:3000 -v docplatform-data:/data ghcr.io/valoryx-org/docplatform:latest Если используете Docker, переходите к шагу 3 — контейнер инициализируется автоматически. https://valoryx.org/ru/docs/guides/editor/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/guides/editor/ Веб-редактор DocPlatform включает редактор форматированного текста на базе Tiptap (основан на ProseMirror), который отображает Markdown в реальном времени, сохраняя полную совместимость с исходным Markdown. Каждое ваше изменение формирует чистый файл .md — без проприетарных форматов и привязки к платформе. Макет редактора ┌─────────────────────────────────────────────────────────────┐ │ Sidebar │ Editor │ │ │ │ │ 📁 Getting │ ┌──────────────────────────────────┐ │ │ Started │ │ Frontmatter (collapsible) │ │ │ 📁 Guides │ │ Title: ___________________ │ │ │ 📁 API │ │ Description: ______________ │ │ │ > auth. https://valoryx.org/ru/cloud/guides/writing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/cloud/guides/writing/ Написание и редактирование Valoryx Cloud предоставляет чистый редактор без отвлекающих элементов, который работает как Google Docs, но хранит всё в Markdown для максимальной переносимости. Создание страницы Откройте рабочее пространство из панели управления Нажмите + New Page в боковой панели Введите заголовок и начните писать Страницы сохраняются автоматически по мере ввода. Каждое сохранение создаёт версию в истории вашего рабочего пространства, поэтому вы всегда можете вернуться к предыдущей. Редактор Редактор имеет два режима: https://valoryx.org/ru/docs/configuration/environment/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/configuration/environment/ Переменные окружения DocPlatform читает конфигурацию из переменных окружения. Устанавливайте их в оболочке, файле .env в рабочей директории или в оркестраторе контейнеров. Сервер Переменная По умолчанию Описание PORT 3000 Порт HTTP-сервера HOST 0.0.0.0 Адрес HTTP-сервера. Установите 127.0.0.1 для ограничения доступа только localhost. DATA_DIR .docplatform Корневая директория для всех данных DocPlatform (база данных, резервные копии, workspaces, ключи) BASE_DOMAIN — Пользовательский домен для опубликованной документации (например, docs.yourcompany.com). При установке опубликованная документация использует этот домен для канонических URL и записей sitemap. https://valoryx.org/ru/docs/deployment/binary/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/deployment/binary/ Развертывание бинарного файла Простейший способ развертывания — скачайте единый бинарный файл и запустите на сервере. Без runtime-зависимостей, контейнеров и оркестратора. Скачивание Получите последний релиз для вашей платформы: # Recommended (auto-detects platform) curl -fsSL https://valoryx.org/install.sh | sh # Or download a specific platform binary manually curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform # Or download a specific version curl -sLO https://github.com/Valoryx-org/releases/releases/download/v0.5.2/docplatform-linux-amd64 Доступные платформы: ОС Архитектура Бинарный файл Linux amd64 docplatform-linux-amd64 Linux arm64 docplatform-linux-arm64 macOS amd64 (Intel) docplatform-darwin-amd64 macOS arm64 (Apple Silicon) docplatform-darwin-arm64 Windows amd64 docplatform-windows-amd64. https://valoryx.org/ru/docs/reference/api/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/reference/api/ Справочник REST API DocPlatform предоставляет RESTful JSON API по адресу /api/v1/. Все endpoints требуют аутентификации, если не указано иное. Базовый URL http://localhost:3000/api/v1 Аутентификация Большинство endpoints требуют JWT access token в заголовке Authorization: Authorization: Bearer eyJhbGciOiJSUzI1NiIs... Получите токены через endpoints входа или OIDC. Жизненный цикл токенов Токен Срок жизни Назначение Access token 15 минут Аутентификация API Refresh token 30 дней Получение новых access token Endpoints аутентификации Регистрация POST /api/v1/auth/register Создание новой учетной записи. https://valoryx.org/ru/docs/guides/markdown/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/guides/markdown/ Markdown и компоненты DocPlatform использует Markdown, совместимый со стандартом CommonMark, с YAML frontmatter и 7 пользовательскими компонентами для создания функциональной интерактивной документации. Основы Markdown DocPlatform поддерживает полную спецификацию CommonMark и распространенные расширения. Заголовки # Heading 1 ## Heading 2 ### Heading 3 #### Heading 4 Заголовки автоматически генерируют якорные идентификаторы для глубоких ссылок: ## My Section -> #my-section. Форматирование текста **Bold text** *Italic text* ~~Strikethrough~~ `Inline code` [Link text](https://example.com)  сразу после установки, с опциональным входом через Google и GitHub OIDC для команд, использующих этих провайдеров. Локальная аутентификация (по умолчанию) Локальная аутентификация работает без какой-либо настройки. Пользователи регистрируются с email и паролем и входят с теми же учетными данными. Как это работает Регистрация — пользователь отправляет email + пароль. Пароль хешируется с помощью argon2id (рекомендованный OWASP 2024 алгоритм). Вход — пользователь отправляет учетные данные. https://valoryx.org/ru/cloud/guides/publishing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/cloud/guides/publishing/ Публикация документации Превратите любое рабочее пространство в красивый публичный сайт документации. Ваши читатели получат быстрый, удобный для поиска и адаптивный интерфейс, а вы — живой сайт, который обновляется каждый раз при сохранении страницы. Как опубликовать Перейдите в Workspace Settings → Published Docs Включите Enable publishing Ваша документация мгновенно доступна по адресу app.valoryx.dev/p/your-workspace-slug/ Вот и всё. Каждая страница вашего рабочего пространства теперь доступна публично. Что видят читатели Опубликованная документация включает: Боковую навигацию — автоматически генерируется из структуры ваших страниц Полнотекстовый поиск — читатели могут мгновенно найти любую страницу или раздел Адаптивную вёрстку — работает на телефонах, планшетах и десктопах Подсветку синтаксиса — все блоки кода отображаются с корректной подсветкой Оглавление — автоматически генерируется из заголовков на каждой странице Тёмную тему — читатели могут переключаться между светлой и тёмной темами Собственные домены На тарифах Team и Business вы можете использовать собственный домен: https://valoryx.org/ru/docs/deployment/docker/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/deployment/docker/ Развертывание Docker DocPlatform поставляется как мультиархитектурный Docker-образ (amd64/arm64) на базе Alpine Linux. Быстрый старт docker run -d \ --name docplatform \ -p 3000:3000 \ -v docplatform-data:/data \ ghcr.io/valoryx-org/docplatform:latest Откройте http://localhost:3000 и зарегистрируйте учетную запись администратора. Первый запуск При первой загрузке DocPlatform автоматически: Создает базу данных SQLite по адресу /data/data.db Генерирует ключ подписи RS256 по адресу /data/jwt-key.pem Инициализирует индекс полнотекстового поиска Начинает слушать на порту 3000 Первый зарегистрированный пользователь становится Super Admin с полным доступом к платформе. https://valoryx.org/ru/docs/reference/cli/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/reference/cli/ Справочник CLI DocPlatform предоставляет 5 команд CLI для управления сервером, инициализации workspace, диагностики и обслуживания. Глобальные параметры Эти параметры применяются ко всем командам: Флаг Описание --help, -h Показать справку для любой команды --version, -v Вывести информацию о версии docplatform serve Запуск HTTP-сервера. docplatform serve [flags] Флаги Флаг По умолчанию Описание --port 3000 Порт HTTP-сервера (переопределяет переменную окружения PORT) --host 0.0.0.0 Адрес HTTP-сервера (переопределяет переменную окружения HOST) --data-dir .docplatform Путь к директории данных (переопределяет переменную окружения DATA_DIR) Поведение Загружает переменные окружения из файла . https://valoryx.org/ru/docs/getting-started/installation/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/getting-started/installation/ Установка DocPlatform поставляется как единый бинарный файл без runtime-зависимостей. Выберите способ установки, который подходит для вашего рабочего процесса. Вариант 1: Готовый бинарный файл (рекомендуется) Скачайте последний релиз для вашей платформы. Linux / macOS # Recommended (auto-detects platform) curl -fsSL https://valoryx.org/install.sh | sh # Or download manually curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform # Verify the installation docplatform version Ожидаемый вывод: docplatform v0.5.2 (commit: abc1234, built: 2026-03-08T10:00:00Z) Windowspowershell# Download and runInvoke-WebRequest https://github. https://valoryx.org/ru/docs/getting-started/first-workspace/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/getting-started/first-workspace/ Ваш первый workspace Workspace — это контейнер верхнего уровня для проекта документации. Каждый workspace соответствует директории с Markdown-файлами и опционально синхронизируется с git-репозиторием. Концепции workspace Концепция Описание Workspace Проект документации, содержащий страницы, участников и настройки Page Markdown-файл с YAML frontmatter (заголовок, описание, теги, доступ) Slug URL-безопасный идентификатор workspace (например, my-docs -> /p/my-docs/) Member Пользователь с ролью в workspace (от Viewer до Workspace Admin) Создание workspace Через CLI docplatform init \ --workspace-name "Engineering Docs" \ --slug eng-docs Через веб-интерфейс Войдите как Super Admin или Workspace Admin Откройте переключатель workspace (выпадающий список вверху слева) Нажмите Create Workspace Введите имя и slug Опционально настройте удаленный git-репозиторий Подключение git-репозитория Двунаправленная синхронизация поддерживает файлы workspace и удаленный git-репозиторий в актуальном состоянии. https://valoryx.org/ru/docs/guides/git-integration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/guides/git-integration/ Интеграция с Git Двунаправленная синхронизация git в DocPlatform позволяет вашей команде работать так, как удобно каждому. Технические писатели используют веб-редактор. Разработчики пушат из IDE. Все видят один и тот же контент. Как это работает ┌─────────────┐ │ Web Editor │ │ (browser) │ └──────┬───────┘ │ save ▼ ┌─────────────┐ ┌──────────────┐ │ Content │ commit │ Local Git │ push ┌──────────────┐ │ Ledger │ ───────► │ Repository │ ───────► │ Remote Repo │ │ │ │ (. https://valoryx.org/ru/cloud/guides/collaboration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/cloud/guides/collaboration/ Командная работа Valoryx Cloud создан для работы в команде. Приглашайте коллег, контролируйте, кто и что может редактировать, и отслеживайте изменения в реальном времени. Приглашение участников Перейдите в Workspace Settings → Members Введите email-адрес коллеги Выберите роль (см. ниже) Нажмите Send Invitation Приглашённый получит письмо со ссылкой для присоединения. Если у него ещё нет аккаунта Valoryx, ему будет предложено создать его. Роли Роль Что может делать Viewer Просматривать все страницы. Не может редактировать или изменять настройки. https://valoryx.org/ru/docs/configuration/permissions/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/configuration/permissions/ Роли и права доступа DocPlatform использует ролевую модель доступа (RBAC) на базе Casbin — авторизационного движка, работающего в рамках процесса. Проверка прав выполняется менее чем за 0.1 мс без обращения к внешним сервисам. Иерархия ролей DocPlatform определяет 5 публичных ролей в строгой иерархии. Более высокие роли наследуют все права более низких. Super Admin ← Full platform access (all workspaces) │ Admin ← Manage workspace settings, git config, theme │ Editor ← Создание и редактирование страниц (настраивается для каждого workspace) │ Commenter ← View pages, leave comments │ Viewer ← View pages only Platform Owner — внутренняя роль для операторов самостоятельно размещённых экземпляров, предназначенная для обслуживания платформы (миграции базы данных, управление лицензиями, конфигурация системы). https://valoryx.org/ru/docs/reference/troubleshooting/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/reference/troubleshooting/ Устранение неполадок В этом руководстве рассмотрены распространенные проблемы и их решения. Для получения диагностической информации всегда начинайте с: docplatform doctor Запуск сервера Сервер не запускается: “address already in use” Причина: Другой процесс использует настроенный порт. Решение: # Find what's using port 3000 lsof -i :3000 # macOS/Linux ss -tlnp | grep 3000 # Linux # Option 1: Stop the other process # Option 2: Use a different port docplatform serve --port 8080 Сервер не запускается: “permission denied” Причина: Процесс не имеет прав чтения/записи к директории данных. https://valoryx.org/ru/docs/deployment/production/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/deployment/production/ Чек-лист для production Используйте этот чек-лист перед развертыванием DocPlatform в production-среде. Каждый пункт ссылается на соответствующий раздел документации. Обязательно Эти пункты необходимы для безопасного и надежного production-развертывания. Сервер Persistent storage настроено — примонтируйте volume или используйте стабильный путь файловой системы для DATA_DIR. Потеря этой директории означает потерю всех данных. Менеджер процессов настроен — используйте systemd, Docker с restart: unless-stopped или оркестратор контейнеров для обеспечения перезапуска сервера после сбоев или перезагрузок. Порт доступен — убедитесь, что настроенный PORT (по умолчанию: 3000) доступен из вашей сети или reverse proxy. https://valoryx.org/ru/docs/guides/collaboration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/guides/collaboration/ Команды и совместная работа DocPlatform создан для командной работы над документацией. Приглашайте участников, назначайте гранулярные роли и отслеживайте каждое изменение с помощью полного журнала аудита. Участники workspace Каждый пользователь принадлежит одному или нескольким workspaces с определенной ролью. Роли определяют, какие действия может выполнять пользователь. Приглашение участников Через веб-интерфейс: Откройте Workspace Settings -> Members Нажмите Invite Member Введите email-адрес приглашаемого Выберите роль Нажмите Send Если настроен SMTP, отправляется email с приглашением и уникальной ссылкой. https://valoryx.org/ru/docs/configuration/workspace-config/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/configuration/workspace-config/ Настройки workspace Каждый workspace имеет собственный файл конфигурации по адресу .docplatform/workspaces/{workspace-id}/.docplatform/config.yaml. Редактируйте этот файл напрямую или используйте веб-интерфейс (Settings -> Workspace). Полный справочник конфигурации # Workspace identity workspace_id: 01KJJ10NTF31Z1QJTG4ZRQZ2Z2 # Auto-generated ULID name: "Engineering Docs" # Display name slug: eng-docs # URL slug for published docs description: "Internal engineering documentation" # Git synchronization git_remote: git@github.com:your-org/eng-docs.git git_branch: main git_auto_commit: true # Auto-commit editor saves to git sync_interval: 300 # Polling interval in seconds (0 = disabled) # Theme theme: mode: auto # light, dark, auto (follows system preference) accent: blue # Accent color for published site # Publishing defaults publishing: default_published: false # New pages published by default? https://valoryx.org/ru/cloud/guides/git-sync/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/cloud/guides/git-sync/ Синхронизация с GitHub Valoryx Cloud может синхронизировать вашу документацию с репозиторием GitHub. Это даёт лучшее из двух миров: красивый веб-редактор И всю мощь git. Зачем подключать GitHub? Резервное копирование — ваша документация всегда в безопасности в GitHub, даже если вы удалите аккаунт Редактирование в IDE — разработчики в вашей команде могут редактировать документацию в VS Code, Vim или любом другом редакторе Pull requests — используйте рабочий процесс PR в GitHub для ревью документации перед публикацией История версий — полный git blame, diff и откат для каждого изменения CI/CD-интеграция — запускайте сборки или тесты при изменении документации Как это работает Вы редактируете в браузере → автосохранение → автокоммит → push в GitHub ↕ Коллега пушит из IDE → GitHub → webhook → pull в Valoryx Изменения передаются в обоих направлениях автоматически. https://valoryx.org/ru/cloud/guides/mcp/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/cloud/guides/mcp/ AI и MCP-интеграция Valoryx Cloud включает встроенный MCP-сервер (Model Context Protocol), который позволяет AI-ассистентам напрямую взаимодействовать с вашей документацией. Что такое MCP? MCP — это стандартный протокол, позволяющий AI-инструментам подключаться к внешним сервисам. Представьте, что это способ дать Claude или Cursor возможность «видеть» вашу документацию и вносить изменения — с вашего разрешения. Что AI может делать с вашей документацией Читать страницы, чтобы отвечать на вопросы о вашей документации Искать по всем страницам для нахождения релевантного контента Создавать новые страницы по вашим инструкциям Редактировать существующие страницы (переписывать, улучшать, переводить) Анализировать документацию на предмет пробелов, несоответствий или устаревшего контента Настройка Статус: размещённый MCP-эндпоинт для Valoryx Cloud ещё не включён — удалённые AI-инструменты пока не могут подключаться к app. https://valoryx.org/ru/docs/guides/publishing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/guides/publishing/ Публикация документации DocPlatform может предоставлять документацию как публичный веб-сайт с боковой навигацией, подсветкой синтаксиса и SEO-метаданными. Отдельный генератор статических сайтов не требуется. Как работает публикация Опубликованная документация доступна по адресу /p/{workspace-slug}/{page-path}: http://localhost:3000/p/my-docs/ → docs/index.md http://localhost:3000/p/my-docs/quickstart → docs/quickstart.md http://localhost:3000/p/my-docs/api/auth → docs/api/auth.md Страницы рендерятся из Markdown в HTML по запросу с использованием goldmark (совместим с CommonMark) и подсветкой синтаксиса Chroma для блоков кода. Жизненный цикл статуса страницы Страницы имеют поле status, управляющее их видимостью: https://valoryx.org/ru/cloud/guides/account/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/cloud/guides/account/ Ваш аккаунт Регистрация Перейдите на app.valoryx.dev и создайте аккаунт, указав email и пароль. Вам потребуется принять Условия использования и Политику конфиденциальности. Вы также можете войти через Google или GitHub, если эти варианты доступны. Настройки профиля Нажмите на аватар в левом верхнем углу, затем Profile, чтобы: Изменить отображаемое имя Обновить email Сменить пароль Настроить passkey (WebAuthn) для входа без пароля Биллинг Перейдите в Workspace Settings → Billing, чтобы: Просмотреть текущий тариф и использование Перейти на тариф Team ($29/мес. https://valoryx.org/ru/docs/guides/search/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/guides/search/ Поиск DocPlatform включает встроенный полнотекстовый поисковый движок (Bleve), который автоматически индексирует весь контент. Не нужно настраивать внешний сервис — поиск работает сразу после установки. Использование поиска Диалог Cmd+K Нажмите Cmd+K (macOS) или Ctrl+K (Windows/Linux) в любом месте веб-редактора, чтобы открыть диалог поиска. ┌──────────────────────────────────────────┐ │ 🔍 Search documentation... │ ├──────────────────────────────────────────┤ │ │ │ 📄 Getting Started │ │ Install and configure DocPlatform... │ │ │ │ 📄 API Authentication │ │ JWT tokens, OAuth2, and session. https://valoryx.org/ru/docs/guides/ai-features/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/guides/ai-features/ AI Features DocPlatform includes built-in AI capabilities powered by Claude (Anthropic) or OpenAI. These features help you write, improve, and explore your documentation faster. Setup Enable AI features by setting your provider and API key: # .env AI_PROVIDER=anthropic # or "openai" AI_API_KEY=sk-ant-... # your API key AI_MODEL= # optional — uses provider default if empty Restart the server. AI features appear in the editor toolbar and are accessible via the API. https://valoryx.org/ru/docs/guides/analytics/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/guides/analytics/ Analytics DocPlatform includes built-in analytics for tracking how your documentation is used. No third-party tracking scripts or external services required. How it works Analytics data is collected in a separate analytics.db SQLite database (not in the main database). This separation ensures analytics never impact content performance. What is tracked Data point Description Page path Which page was viewed Referrer Where the visitor came from Timestamp When the page was viewed Search queries What users searched for What is NOT tracked IP addresses (never stored) User agents are not stored Cookies or cross-session identifiers (without consent) Personally identifiable information GDPR compliance Analytics requires explicit cookie consent from visitors. https://valoryx.org/ru/docs/guides/billing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/guides/billing/ Billing & Plans DocPlatform uses Stripe for subscription billing. Three plan tiers are available, each with different limits and features. Plans Feature Community (Free) Free Team ($29/mo) Business ($79/mo) Editors Unlimited 3 15 50 Workspaces Unlimited 1 3 10 Viewers / Commenters Unlimited Unlimited Unlimited Unlimited Pages Unlimited 50 150 500 Published docs Unlimited Unlimited Unlimited Unlimited Analytics — — Included Included Custom domains — — Included Included Advanced AI — — Included Included Priority support — — — Included Annual pricing Annual subscriptions include 2 months free: https://valoryx.org/ru/docs/guides/mcp/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/guides/mcp/ MCP Server — AI Integration Guide DocPlatform includes a built-in Model Context Protocol (MCP) server that lets AI assistants read, write, search, and manage your documentation directly. Instead of copy-pasting content into chat windows, your AI tools work with your docs natively. Prerequisites DocPlatform running (binary, Docker, or Fly.io) An API key (create one in Workspace Settings → API Keys) Quick start 1. Create an API key In your DocPlatform instance, go to Workspace Settings → API Keys → Create Key. https://valoryx.org/ru/changelog/v0.11.1/ Wed, 10 Jun 2026 00:00:00 +0000 https://valoryx.org/ru/changelog/v0.11.1/ Эта запись объединяет всё, что вышло между v0.6.4 и v0.11.1. Полная детализация по каждому релизу входит в changelog документации продукта. MCP-сервер: 26 инструментов Встроенный MCP-сервер вырос с 13 до 26 инструментов — CRUD контента, поиск, RAG-пакеты контекста, проверка качества, версионирование, экспорт, AI-помощь при написании, комментарии, активность, публикация рабочих пространств и разрешение конфликтов git-синхронизации. Два транспорта: stdio для локальных AI-инструментов, Streamable HTTP для облачного доступа. См. страницу MCP. Публикация как код Оверлей публикации — . https://valoryx.org/ru/blog/ai-native-documentation/ Mon, 13 Apr 2026 00:00:00 +0000 https://valoryx.org/ru/blog/ai-native-documentation/ У документации проблема с обслуживанием. Вы пишете руководство, публикуете его, и через три месяца оно устарело. API изменился. Формат конфигурации переработан. Зависимость заменена. На скриншотах интерфейс, которого больше не существует. Решение не в том, чтобы «писать лучшую документацию» или «строить культуру документации». Команды пытаются это делать десятилетиями. Решение в том, чтобы документация знала о коде, который описывает, — чтобы при изменении кода документация об этом узнавала. Вот что означает ИИ-нативная документация. https://valoryx.org/ru/blog/documentation-platform-cost/ Thu, 09 Apr 2026 00:00:00 +0000 https://valoryx.org/ru/blog/documentation-platform-cost/ Поюзерное ценообразование выглядит разумно на первый взгляд. Пять пользователей по $8/мес? Это $40. Ваша команда может позволить $40. Но документация — это один из тех инструментов, где число людей, которые должны иметь доступ, постоянно растёт. Инженерам нужно писать. Продакт-менеджерам нужно проверять. Поддержке нужно ссылаться. Новым сотрудникам нужно читать и комментировать. Внезапно у вас не 5 мест — а 50, и эти «доступные» $8/место превращаются в $400/мес за инструмент, который хранит текстовые файлы. https://valoryx.org/ru/blog/docs-for-open-source/ Mon, 06 Apr 2026 00:00:00 +0000 https://valoryx.org/ru/blog/docs-for-open-source/ Проекты с открытым исходным кодом живут или умирают благодаря документации. Библиотека с хорошей документацией находит пользователей. Библиотека с голым README и подходом «смотрите код» форкается тем, кто напишет лучшую документацию — или просто игнорируется. Но большинство инструментов документации создано для компаний, а не для мейнтейнеров OSS. Они берут плату за пользователя, за страницу или за workspace. Для проекта, поддерживаемого волонтёрами с нулевым бюджетом, это неприемлемо. Мы создали Community Edition DocPlatform бесплатным навсегда, без ограничений. https://valoryx.org/ru/blog/documentation-search-works/ Thu, 02 Apr 2026 00:00:00 +0000 https://valoryx.org/ru/blog/documentation-search-works/ Вы вводите запрос в строку поиска документации. Появляются результаты. Но что произошло между нажатием клавиши и результатами? Для большинства платформ документации ответ — либо «немного» (простое сопоставление ключевых слов, которое пропускает очевидные результаты), либо «много инфраструктуры» (кластер Elasticsearch, который ваша команда эксплуатации должна поддерживать). Есть золотая середина, о которой большинство команд не знают: встроенный полнотекстовый поиск. DocPlatform использует Bleve, поисковую библиотеку на Go, скомпилированную прямо в бинарный файл. Никаких внешних сервисов, сетевых вызовов, кластеров для управления — но с функциями, которые вам реально нужны: стемминг, нечёткий поиск, бустинг полей и ранжирование по релевантности. https://valoryx.org/ru/blog/single-binary-architecture/ Mon, 30 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/blog/single-binary-architecture/ Большинство платформ документации поставляются как стек. Вы получаете Node.js-приложение, базу данных PostgreSQL, кэш Redis, кластер Elasticsearch для поиска и обратный прокси Nginx, чтобы связать всё вместе. Пять сервисов, пять вещей, которые могут сломаться, пять вещей для мониторинга, обновления и патчинга. DocPlatform поставляется как один файл. Скачайте, запустите, готово. Это не маркетинговый трюк. Это архитектурное решение, принятое в первый день, и каждый последующий выбор проектирования вытекает из него. Вот почему. Типичный стек документации Давайте посмотрим, что вы реально развёртываете при настройке современной платформы документации: https://valoryx.org/ru/blog/keep-docs-up-to-date/ Thu, 26 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/blog/keep-docs-up-to-date/ У каждой инженерной команды одна и та же проблема с документацией. Кто-то пишет подробную документацию при запуске. Через полгода API изменился, формат конфигурации другой, а три страницы ссылаются на функцию, которую переименовали. Никто не обновил документацию, потому что обновление документации — это отдельная задача от написания кода, а отдельные задачи забываются. Обычный совет — «сделайте документацию частью культуры» — не работает. Культура не выдерживает давления дедлайнов. Работает то, что делает обновление документации частью существующих рабочих процессов, чтобы оно происходило автоматически или с минимальным трением. https://valoryx.org/ru/blog/docs-regulated-industries/ Mon, 23 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/blog/docs-regulated-industries/ Если вы работаете в здравоохранении, оборонной промышленности, финансах или любой отрасли, где важна резидентность данных, у вас наверняка уже был такой разговор: «Можно ли нам использовать этот SaaS-инструмент, или нужно пройти шестимесячную проверку безопасности?» Для большинства облачных платформ документации ответ — проверка, и часто она заканчивается словом «нет». Проблема не в том, что облачные инструменты небезопасны. Большинство из них компетентны в вопросах безопасности. Проблема в контроле. Регулируемые среды должны доказать, где находятся данные, кто имеет к ним доступ, как они зашифрованы и что происходит при инциденте. https://valoryx.org/ru/blog/bidirectional-git-sync/ Thu, 19 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/blog/bidirectional-git-sync/ Каждая платформа документации со страницей интеграции с git даёт одно и то же обещание: ваша документация живёт в git, команда редактирует в браузере, и всё остаётся синхронизированным. На практике большинство этих интеграций — односторонние зеркала, которые разваливаются, как только два человека вносят правки с разных сторон. Мы написали о том, почему это происходит, в предыдущей статье. Эта идёт глубже в решение: как Valoryx реализует двунаправленную синхронизацию с использованием паттерна Content Ledger и почему этот подход справляется со сценариями, которые ломают другие инструменты. https://valoryx.org/ru/blog/mcp-documentation-guide/ Mon, 16 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/blog/mcp-documentation-guide/ Model Context Protocol (MCP) — это открытый стандарт, позволяющий ИИ-ассистентам взаимодействовать с внешними инструментами и источниками данных через структурированный интерфейс. Вместо копирования текста в окно чата в надежде, что модель поймёт контекст, MCP даёт ассистенту прямой типизированный доступ к вашим системам — чтение файлов, выполнение поиска, создание контента — всё через чётко определённые вызовы инструментов. Для команд, работающих с документацией, это фундаментально меняет рабочий процесс. Ваш ИИ-ассистент перестаёт быть генератором текста, работающим из устаревшего контекста, и становится участником, который читает реальную документацию, ищет по всей базе знаний и вносит правки, которые вы можете проверить перед публикацией. https://valoryx.org/ru/blog/internal-docs-developers-use/ Thu, 12 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/blog/internal-docs-developers-use/ В каждой инженерной организации есть внутренняя документация. И в большинстве из них эта документация неполна, устарела или игнорируется. Согласно опросу разработчиков Stack Overflow 2024, большинство разработчиков считают плохую или отсутствующую документацию серьёзным барьером для продуктивности. Это не проблема дисциплины. Это проблема инструментов. Внутренняя документация терпит неудачу по конкретным, устранимым причинам. Инструменты делают написание болезненным. Контент устаревает, потому что ни у кого нет рабочего процесса для поддержания актуальности. Поиск плохо работает, поэтому разработчики идут сразу в Slack. https://valoryx.org/ru/blog/docs-should-be-in-git/ Mon, 09 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/blog/docs-should-be-in-git/ Вот список того, что типичная инженерная команда хранит в git: Исходный код приложения Описания инфраструктуры (Terraform, Pulumi, CloudFormation) Конфигурации CI/CD-пайплайнов Скрипты миграции базы данных Спецификации API (OpenAPI, protobuf) Манифесты развёртывания (Kubernetes, Docker Compose) Шаблоны конфигурации окружения А вот что обычно живёт вне git: Документация Это странно. Документация описывает систему. Она меняется, когда меняется система. Она нуждается в ревью, версионировании, атрибуции и возможности отката. Каждый другой артефакт с этими свойствами живёт в git. https://valoryx.org/ru/changelog/v0.5.2/ Sat, 07 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/changelog/v0.5.2/ Интеграция биллинга Встроенный биллинг на базе Stripe. Настраивайте тарифы, управляйте подписками и обрабатывайте обновления прямо из панели администратора. Интеграция вебхуков Stripe с 5 типами событий Управление жизненным циклом подписок (создание, обновление, отмена) Учёт потребления для API-вызовов и хранилища Генерация счетов и история платежей Настраиваемые лимиты тарифов для каждого рабочего пространства Панель аналитики Отслеживайте эффективность документации с помощью новой панели аналитики. Отслеживание просмотров страниц с агрегацией по дням, неделям и месяцам Самые просматриваемые страницы и популярный контент Аналитика поисковых запросов с отслеживанием запросов без результатов Метрики вовлечённости пользователей (время на странице, глубина прокрутки) Экспорт аналитических данных в CSV AI-помощник для написания текстов AI-инструменты для работы с текстом, интегрированные непосредственно в редактор. https://valoryx.org/ru/blog/documentation-as-code/ Thu, 05 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/blog/documentation-as-code/ «Документация как код» — выражение, которое звучит повсюду. В самом простом виде это означает обращение с документацией так же, как с исходным кодом: хранение в системе контроля версий, написание в виде простого текста, ревью через pull request, сборка через CI/CD. Но между идеей и её качественной реализацией есть разрыв. Это руководство описывает, что такое docs-as-code, какие подходы существуют и в чём каждый из них уступает. Почему docs-as-code важен У программных команд уже есть рабочие процессы для управления изменениями. https://valoryx.org/ru/blog/self-host-docs-5-minutes/ Mon, 02 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/blog/self-host-docs-5-minutes/ Большинство инструментов для самостоятельного хостинга документации требуют базу данных, обратный прокси и полдня правки YAML, прежде чем вы увидите экран приветствия. DocPlatform — это один бинарный файл на Go без внешних зависимостей. Это руководство проведёт вас от нуля до опубликованной документации примерно за пять минут. Требования Вам нужен компьютер с Linux, macOS или Windows. Всё. Без Docker, без PostgreSQL, без Node.js. DocPlatform компилируется в один статический бинарный файл — среда Go встроена. https://valoryx.org/ru/blog/notion-alternative-self-hosted/ Sun, 01 Mar 2026 00:00:00 +0000 https://valoryx.org/ru/blog/notion-alternative-self-hosted/ Notion есть везде. Команды разработчиков всё активнее используют его для технической документации. Он работает — до определённого момента. Что Notion делает правильно Быстрый и гибкий редактор. Полезные представления баз данных. Хорош для нетехнической документации. Где Notion даёт сбой Нет интеграции с git. Документация хранится в проприетарной базе данных Notion, оторванной от кодовой базы. Расхождение документации с кодом практически неизбежно. Привязка к платформе. Экспорт в markdown неаккуратен. Проприетарные блоки становятся неопределёнными. Ваша документация — в заложниках. https://valoryx.org/ru/blog/self-hosted-docs-guide/ Fri, 27 Feb 2026 00:00:00 +0000 https://valoryx.org/ru/blog/self-hosted-docs-guide/ Self-hosted документация переживает подъём. После многих лет, когда SaaS-платформы повышали цены, меняли условия использования и закрывались без предупреждения, всё больше команд выбирают собственную инфраструктуру для хранения документации. Причины очевидны: владение данными, контроль затрат, соответствие нормативным требованиям и уверенность в том, что база знаний не исчезнет, когда у стартапа закончится финансирование. Однако рынок self-hosted документации перенасыщен и запутан. Существуют wiki-платформы, генераторы статических сайтов, базы знаний и гибридные инструменты — каждый со своими компромиссами. https://valoryx.org/ru/blog/gitbook-vs-valoryx/ Wed, 25 Feb 2026 00:00:00 +0000 https://valoryx.org/ru/blog/gitbook-vs-valoryx/ GitBook — одна из самых популярных платформ документации для команд разработчиков. Мы создали Valoryx, чтобы решить проблемы, которые GitBook не решает: владение git-репозиторием, self-hosting и прозрачность ценообразования. Опыт работы с редактором GitBook: отличный блочный редактор, зрелые инструменты совместной работы. Valoryx: WYSIWYG на базе Tiptap, более быстрый, чистый markdown. Вердикт: GitBook зрелее; Valoryx быстрее и генерирует более чистый markdown. Интеграция с git «Git Sync» в GitBook не является по-настоящему двусторонним — push из IDE вызывает конфликты слияния. https://valoryx.org/ru/blog/why-git-sync-breaks/ Sun, 22 Feb 2026 00:00:00 +0000 https://valoryx.org/ru/blog/why-git-sync-breaks/ Вы подключаете репозиторий, делаете push из IDE — и получаете конфликты слияния. Потерянные правки. Молчаливые откаты. Это фундаментальный архитектурный изъян. Три способа сломать git sync 1. Одностороннее зеркалирование. Большинство платформ используют git как резервную копию. Push из IDE вызывает конфликты. 2. Приоритет базы данных над git. Wiki.js: база данных — источник истины. Git — экспорт только для чтения. Нельзя сделать git clone, push и увидеть результат в интерфейсе. 3. Деструктивное разрешение конфликтов. https://valoryx.org/ru/vs/gitbook/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/vs/gitbook/