https://valoryx.org/uk/ Recent content in Valoryx — Git-Native Платформа Документації on Valoryx Hugo uk Wed, 10 Jun 2026 00:00:00 +0000 https://valoryx.org/uk/docs/guides/editor/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/guides/editor/ Веб-редактор DocPlatform містить редактор форматованого тексту, побудований на Tiptap (на базі ProseMirror), який відображає Markdown у реальному часі, зберігаючи повну сумісність із сирцевим Markdown. Кожна ваша зміна створює чистий .md файл — без пропрієтарних форматів, без прив’язки до платформи. Розташування елементів редактора ┌─────────────────────────────────────────────────────────────┐ │ Sidebar │ Editor │ │ │ │ │ 📁 Getting │ ┌──────────────────────────────────┐ │ │ Started │ │ Frontmatter (collapsible) │ │ │ 📁 Guides │ │ Title: ___________________ │ │ │ 📁 API │ │ Description: ______________ │ │ │ > auth. https://valoryx.org/uk/docs/reference/api/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/reference/api/ Довідник REST API DocPlatform надає RESTful JSON API за адресою /api/v1/. Усі ендпоінти вимагають автентифікації, якщо не вказано інше. Базова URL http://localhost:3000/api/v1 Автентифікація Більшість ендпоінтів вимагають JWT токен доступу в заголовку Authorization: Authorization: Bearer eyJhbGciOiJSUzI1NiIs... Отримайте токени через ендпоінти login або OIDC. Життєвий цикл токенів Токен Час життя Призначення Токен доступу 15 хвилин Автентифікація API Токен оновлення 30 днів Отримання нових токенів доступу Ендпоінти автентифікації Реєстрація POST /api/v1/auth/register Створення нового облікового запису. https://valoryx.org/uk/docs/configuration/environment/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/configuration/environment/ Змінні середовища DocPlatform зчитує конфігурацію зі змінних середовища. Встановіть їх в оболонці, у файлі .env в робочій директорії або в оркестраторі контейнерів. Сервер Змінна За замовчуванням Опис PORT 3000 HTTP порт прослуховування HOST 0.0.0.0 HTTP адреса прослуховування. Встановіть 127.0.0.1, щоб обмежити лише localhost. DATA_DIR .docplatform Коренева директорія для всіх даних DocPlatform (база даних, резервні копії, робочі простори, ключі) BASE_DOMAIN — Власний домен для опублікованої документації (наприклад, docs.yourcompany.com). Коли встановлено, опублікована документація використовує цей домен для канонічних URL та записів sitemap. https://valoryx.org/uk/cloud/guides/writing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/cloud/guides/writing/ Написання та редагування Valoryx Cloud надає вам чистий редактор без відволікань, який працює як Google Docs — але зберігає все у Markdown для максимальної портативності. Створення сторінки Відкрийте робочий простір з панелі керування Натисніть + New Page у бічній панелі Введіть заголовок і починайте писати Сторінки зберігаються автоматично під час введення тексту. Кожне збереження створює версію в історії робочого простору, тому ви завжди можете повернутися до попереднього стану. Редактор Редактор має два режими: https://valoryx.org/uk/docs/deployment/binary/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/deployment/binary/ Розгортання бінарного файлу Найпростіший метод розгортання — завантажте один бінарний файл, запустіть його на сервері. Без залежностей часу виконання, без контейнерів, без оркестратора. Завантаження Отримайте останній реліз для вашої платформи: # 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/uk/docs/getting-started/quickstart/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/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/uk/docs/guides/markdown/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/guides/markdown/ Markdown та компоненти DocPlatform використовує Markdown, сумісний із CommonMark, з YAML frontmatter та 7 користувацькими компонентами для багатої інтерактивної документації. Основи Markdown DocPlatform підтримує повну специфікацію CommonMark плюс поширені розширення. Заголовки # Heading 1 ## Heading 2 ### Heading 3 #### Heading 4 Заголовки автоматично генерують anchor ID для глибоких посилань: ## My Section → #my-section. Форматування тексту **Bold text** *Italic text* ~~Strikethrough~~ `Inline code` [Link text](https://example.com)  Списки - Unordered item - Another item - Nested item 1. https://valoryx.org/uk/docs/configuration/authentication/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/configuration/authentication/ Автентифікація DocPlatform підтримує локальну автентифікацію (email + пароль) одразу після встановлення, з опціональним входом через Google та GitHub OIDC для команд, що використовують цих провайдерів. Локальна автентифікація (за замовчуванням) Локальна автентифікація працює без жодної конфігурації. Користувачі реєструються з email та паролем, і входять з тими ж обліковими даними. Як це працює Реєстрація — Користувач надсилає email + пароль. Пароль хешується за допомогою argon2id (рекомендований алгоритм OWASP 2024). Вхід — Користувач надсилає облікові дані. https://valoryx.org/uk/docs/getting-started/installation/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/getting-started/installation/ Встановлення DocPlatform постачається як єдиний бінарний файл без залежностей часу виконання. Оберіть спосіб встановлення, який відповідає вашому робочому процесу. Варіант 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/uk/docs/reference/cli/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/reference/cli/ Довідник CLI DocPlatform надає 5 команд CLI для управління сервером, ініціалізації робочих просторів, діагностики та обслуговування. Глобальні опції Ці опції застосовуються до всіх команд: Прапорець Опис --help, -h Показати довідку для будь-якої команди --version, -v Показати інформацію про версію docplatform serve Запуск HTTP сервера. docplatform serve [flags] Прапорці Прапорець За замовчуванням Опис --port 3000 HTTP порт прослуховування (перевизначає змінну середовища PORT) --host 0.0.0.0 HTTP адреса прослуховування (перевизначає змінну середовища HOST) --data-dir . https://valoryx.org/uk/cloud/guides/publishing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/cloud/guides/publishing/ Публікація документації Перетворіть будь-який робочий простір на гарний публічний сайт документації. Ваші читачі отримають швидкий, зручний для пошуку та адаптивний інтерфейс — а ви отримаєте живий сайт, який оновлюється щоразу, коли ви зберігаєте сторінку. Як опублікувати Перейдіть у Workspace Settings → Published Docs Увімкніть Enable publishing Ваша документація миттєво стає доступною за адресою app.valoryx.dev/p/your-workspace-slug/ Ось і все. Кожна сторінка вашого робочого простору тепер публічно доступна. Що бачать читачі Опублікована документація включає: https://valoryx.org/uk/docs/deployment/docker/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/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/uk/docs/getting-started/first-workspace/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/getting-started/first-workspace/ Ваш перший робочий простір Робочий простір — це контейнер верхнього рівня для проєкту документації. Кожен робочий простір відповідає директорії Markdown файлів та опціонально синхронізується з git репозиторієм. Концепції робочого простору Концепція Опис Робочий простір Проєкт документації, що містить сторінки, учасників та налаштування Сторінка Markdown файл із YAML frontmatter (назва, опис, теги, доступ) Slug URL-безпечний ідентифікатор вашого робочого простору (наприклад, my-docs → /p/my-docs/) Учасник Користувач із роллю в робочому просторі (від Viewer до Admin) Створення робочого простору Через CLI docplatform init \ --workspace-name "Engineering Docs" \ --slug eng-docs Через веб-інтерфейс Увійдіть як Super Admin або Admin Відкрийте перемикач робочих просторів (випадаючий список зверху зліва) Натисніть Create Workspace Введіть назву та slug Опціонально налаштуйте віддалений git репозиторій Підключення git репозиторію Двонаправлена синхронізація підтримує файли робочого простору та віддалений git репозиторій в актуальному стані. https://valoryx.org/uk/docs/guides/git-integration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/guides/git-integration/ Інтеграція з Git Двонаправлена синхронізація git у DocPlatform дозволяє вашій команді працювати так, як їм зручно. Технічні письменники використовують веб-редактор. Розробники відправляють із IDE. Усі бачать однаковий контент. Як це працює ┌─────────────┐ │ Web Editor │ │ (browser) │ └──────┬───────┘ │ save ▼ ┌─────────────┐ ┌──────────────┐ │ Content │ commit │ Local Git │ push ┌──────────────┐ │ Ledger │ ───────► │ Repository │ ───────► │ Remote Repo │ │ │ │ (. https://valoryx.org/uk/cloud/guides/collaboration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/cloud/guides/collaboration/ Командна робота Valoryx Cloud створений для команд. Запрошуйте колег, контролюйте, хто може редагувати, та бачте зміни в реальному часі. Запрошення учасників Перейдіть у Workspace Settings → Members Введіть електронну адресу колеги Оберіть роль (див. нижче) Натисніть Send Invitation Колега отримає лист із посиланням для приєднання. Якщо в нього ще немає облікового запису Valoryx, йому буде запропоновано створити його. Ролі Роль Що може робити Viewer Переглядати всі сторінки. Не може редагувати чи змінювати налаштування. https://valoryx.org/uk/docs/deployment/production/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/deployment/production/ Контрольний список для виробництва Використовуйте цей контрольний список перед розгортанням DocPlatform у виробничому середовищі. Кожен пункт посилається на відповідний розділ документації. Обов’язково Ці пункти необхідні для безпечного та надійного виробничого розгортання. Сервер Постійне сховище налаштовано — Підключіть том або використовуйте стабільний шлях файлової системи для DATA_DIR. Втрата цієї директорії означає втрату всіх даних. Менеджер процесів на місці — Використовуйте systemd, Docker з restart: unless-stopped або оркестратор контейнерів для забезпечення перезапуску сервера після аварій або перезавантажень. https://valoryx.org/uk/docs/configuration/permissions/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/configuration/permissions/ Ролі та права доступу DocPlatform використовує контроль доступу на основі ролей (RBAC) на базі вбудованого авторизаційного рушія, що працює в процесі. Перевірка прав доступу виконується менш ніж за 0,1 мс без зовнішнього сервісу. Ієрархія ролей DocPlatform визначає 5 ролей у строгій ієрархії. Вищі ролі успадковують усі права нижчих ролей. Super Admin ← Повний доступ до платформи (усі робочі простори) │ Admin ← Управління налаштуваннями робочого простору, учасниками, git, темою │ Editor ← Створення та редагування сторінок (налаштовується для кожного workspace) │ Commenter ← Перегляд сторінок, залишення коментарів │ Viewer ← Лише перегляд сторінок Platform Owner — внутрішня роль для операторів самостійно розгорнутих екземплярів, призначена для обслуговування платформи (міграції бази даних, управління ліцензіями, конфігурація системи). https://valoryx.org/uk/docs/reference/troubleshooting/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/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/uk/docs/guides/collaboration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/guides/collaboration/ Команди та співпраця DocPlatform розроблений для командної документації. Запрошуйте учасників, призначайте детальні ролі та відстежуйте кожну зміну за допомогою повного журналу аудиту. Членство в робочому просторі Кожен користувач належить до одного або кількох робочих просторів із конкретною роллю. Ролі визначають, які дії може виконувати користувач. Запрошення учасників Через веб-інтерфейс: Відкрийте Workspace Settings → Members Натисніть Invite Member Введіть електронну адресу особи Оберіть роль Натисніть Send Якщо SMTP налаштовано, надсилається електронний лист із запрошенням з унікальним посиланням. https://valoryx.org/uk/docs/configuration/workspace-config/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/configuration/workspace-config/ Налаштування робочого простору Кожен робочий простір має власний конфігураційний файл за адресою .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/uk/cloud/guides/git-sync/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/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 ↕ Колега робить push з IDE → GitHub → webhook → pull до Valoryx Зміни передаються в обох напрямках автоматично. https://valoryx.org/uk/cloud/guides/mcp/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/cloud/guides/mcp/ AI та інтеграція з MCP Valoryx Cloud має вбудований MCP-сервер (Model Context Protocol), який дозволяє AI-асистентам взаємодіяти з вашою документацією напряму. Що таке MCP? MCP — це стандартний протокол, який дозволяє AI-інструментам підключатися до зовнішніх сервісів. Уявіть, що це спосіб дати Claude або Cursor можливість “бачити” вашу документацію та вносити зміни — з вашого дозволу. Що AI може робити з вашою документацією Читати сторінки, щоб відповідати на питання про вашу документацію Шукати по всіх сторінках, щоб знаходити потрібний контент Створювати нові сторінки за вашими інструкціями Редагувати наявні сторінки (переписувати, покращувати, перекладати) Аналізувати документацію на предмет прогалин, неточностей або застарілого контенту Налаштування Статус: хмарний MCP-ендпоінт для Valoryx Cloud ще не увімкнено — віддалені ШІ-інструменти поки не можуть під’єднатися до app. https://valoryx.org/uk/docs/guides/publishing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/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/uk/cloud/guides/account/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/cloud/guides/account/ Ваш обліковий запис Реєстрація Відвідайте app.valoryx.dev та створіть обліковий запис за допомогою електронної пошти та пароля. Вам потрібно буде прийняти Умови використання та Політику конфіденційності. Ви також можете увійти через Google або GitHub, якщо ці варіанти доступні. Налаштування профілю Натисніть на аватар у верхньому лівому куті, потім Profile, щоб: Змінити відображуване ім’я Оновити електронну адресу Змінити пароль Налаштувати passkey (WebAuthn) для входу без пароля Оплата Перейдіть у Workspace Settings → Billing, щоб: https://valoryx.org/uk/docs/guides/search/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/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/uk/docs/guides/ai-features/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/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/uk/docs/guides/analytics/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/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/uk/docs/guides/billing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/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/uk/docs/guides/mcp/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/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/uk/changelog/v0.11.1/ Wed, 10 Jun 2026 00:00:00 +0000 https://valoryx.org/uk/changelog/v0.11.1/ Цей запис об’єднує все, що вийшло між v0.6.4 та v0.11.1. Повна деталізація за кожним релізом входить до changelog документації продукту. MCP-сервер: 26 інструментів Вбудований MCP-сервер виріс із 13 до 26 інструментів — CRUD контенту, пошук, RAG-пакети контексту, перевірка якості, версіонування, експорт, ШІ-допомога при написанні, коментарі, активність, публікація робочих просторів і розв’язання конфліктів git-синхронізації. Два транспорти: stdio для локальних ШІ-інструментів, Streamable HTTP для хмарного доступу. Див. сторінку MCP. Публікація як код Оверлей публікації — . https://valoryx.org/uk/blog/ai-native-documentation/ Mon, 13 Apr 2026 00:00:00 +0000 https://valoryx.org/uk/blog/ai-native-documentation/ Документація має проблему обслуговування. Ви пишете посібник, публікуєте його, і за три місяці він застарів. API змінився. Формат конфігурації переробили. Залежність замінили. Скріншоти показують інтерфейс, якого більше не існує. Рішення — не «пишіть кращу документацію» чи «побудуйте культуру документації». Команди намагаються це робити вже десятиліттями. Рішення — зробити документацію обізнаною про код, який вона описує, — щоб коли код змінюється, документація про це знала. Саме це означає ШІ-нативна документація. Не «ШІ пише вашу документацію» (це створює шаблонний, бездушний контент). https://valoryx.org/uk/blog/documentation-platform-cost/ Thu, 09 Apr 2026 00:00:00 +0000 https://valoryx.org/uk/blog/documentation-platform-cost/ Ціноутворення за кількістю користувачів виглядає розумно на перший погляд. П’ять користувачів по $8/місяць? Це $40. Ваша команда може собі дозволити $40. Але документація — це один із тих інструментів, де кількість людей, які повинні мати доступ, постійно зростає. Інженери повинні писати. Продакт-менеджери повинні рецензувати. Підтримка повинна звертатися. Нові співробітники повинні читати та коментувати. Раптом у вас не 5 місць — а 50, і ці «доступні» $8/місце стають $400/місяць за інструмент, що зберігає текстові файли. https://valoryx.org/uk/blog/docs-for-open-source/ Mon, 06 Apr 2026 00:00:00 +0000 https://valoryx.org/uk/blog/docs-for-open-source/ Проєкти з відкритим кодом живуть або вмирають завдяки документації. Бібліотека з чудовою документацією отримує користувачів. Бібліотека з голим README та підходом «дивіться код» форкається кимось, хто пише кращу документацію — або просто ігнорується. Але більшість інструментів документації створені для компаній, а не для мейнтейнерів відкритого коду. Вони беруть плату за користувача, за сторінку або за workspace. Для проєкту, який підтримують волонтери з нульовим бюджетом, це неприйнятно. Ми створили Community Edition DocPlatform безкоштовним назавжди, без обмежень. https://valoryx.org/uk/blog/documentation-search-works/ Thu, 02 Apr 2026 00:00:00 +0000 https://valoryx.org/uk/blog/documentation-search-works/ Ви вводите запит у рядок пошуку документації. З’являються результати. Але що відбулося між натисканням клавіші та результатами? Для більшості платформ документації відповідь або «небагато» (просте зіставлення ключових слів, що пропускає очевидні результати), або «багато інфраструктури» (кластер Elasticsearch, який ваша команда ops повинна підтримувати). Є золота середина, про яку більшість команд не знає: вбудований повнотекстовий пошук. DocPlatform використовує Bleve, пошукову бібліотеку на Go, скомпільовану безпосередньо в бінарний файл. Жодних зовнішніх сервісів, жодних мережевих викликів, жодних кластерів для управління — але з функціями, які вам дійсно потрібні: стемінг, нечітке зіставлення, підсилення полів і ранжування за релевантністю. https://valoryx.org/uk/blog/single-binary-architecture/ Mon, 30 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/blog/single-binary-architecture/ Більшість платформ документації поставляються як стек. Ви отримуєте Node.js-додаток, базу даних PostgreSQL, кеш Redis, кластер Elasticsearch для пошуку та зворотний проксі Nginx, щоб зв’язати все разом. П’ять сервісів, п’ять точок відмови, п’ять речей для моніторингу, патчінгу та оновлення. DocPlatform поставляється як один файл. Завантажте, запустіть, готово. Це не маркетинговий трюк. Це архітектурне рішення, прийняте в перший день, і кожен наступний вибір дизайну випливає з нього. Ось чому. Типовий стек документації Подивімось, що ви насправді розгортаєте, коли налаштовуєте сучасну платформу документації: https://valoryx.org/uk/blog/keep-docs-up-to-date/ Thu, 26 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/blog/keep-docs-up-to-date/ Кожна інженерна команда має одну й ту саму проблему з документацією. Хтось пише ґрунтовну документацію під час запуску. Через шість місяців API змінився, формат конфігурації інший, і три сторінки посилаються на функцію, яку перейменували. Ніхто не оновив документацію, бо оновлення документації — це окреме завдання від написання коду, а окремі завдання забуваються. Звична порада — «зробіть документацію частиною вашої культури» — не працює. Культура не витримує тиску дедлайнів. Що працює — це зробити оновлення документації частиною існуючих процесів, щоб вони відбувалися автоматично або з мінімальним тертям. https://valoryx.org/uk/blog/docs-regulated-industries/ Mon, 23 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/blog/docs-regulated-industries/ Якщо ви працюєте в охороні здоров’я, обороні, фінансах або будь-якій галузі, де важлива резидентність даних, ви вже мали цю розмову: «Чи можемо ми використовувати цей SaaS-інструмент, чи він повинен пройти шестимісячний аудит безпеки?» Для більшості хмарних платформ документації відповідь — аудит, і він часто закінчується словом «ні». Справа не в тому, що хмарні інструменти небезпечні. Більшість із них компетентні в безпеці. Справа в контролі. Регульовані середовища повинні довести, де зберігаються дані, хто має доступ, як вони зашифровані та що відбувається, коли щось іде не так. https://valoryx.org/uk/blog/bidirectional-git-sync/ Thu, 19 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/blog/bidirectional-git-sync/ Кожна платформа документації зі сторінкою інтеграції з git дає ту саму обіцянку: ваша документація живе в git, ваша команда редагує в браузері, і все залишається синхронізованим. На практиці більшість із цих інтеграцій — це одностороннє дзеркало, що руйнується в момент, коли дві людини редагують з різних боків. Ми писали про чому це відбувається у попередньому пості. Цей пост заглиблюється в рішення: як Valoryx реалізує двосторонню синхронізацію за допомогою патерну Content Ledger і чому цей підхід обробляє сценарії, що ламають інші інструменти. https://valoryx.org/uk/blog/mcp-documentation-guide/ Mon, 16 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/blog/mcp-documentation-guide/ Model Context Protocol (MCP) — це відкритий стандарт, що дозволяє ШІ-помічникам взаємодіяти із зовнішніми інструментами та джерелами даних через структурований інтерфейс. Замість копіювання тексту у вікно чату з надією, що модель зрозуміє контекст, MCP дає помічнику прямий, типізований доступ до ваших систем — читання файлів, виконання пошуку, створення контенту — все через чітко визначені виклики інструментів. Для команд документації це кардинально змінює процес роботи. Ваш ШІ-помічник перестає бути генератором тексту, що працює з застарілим контекстом, і стає учасником, який читає вашу фактичну документацію, шукає по базі знань і вносить зміни, які ви можете переглянути перед публікацією. https://valoryx.org/uk/blog/internal-docs-developers-use/ Thu, 12 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/blog/internal-docs-developers-use/ Кожна інженерна організація має внутрішню документацію. І в більшості з них ця документація неповна, застаріла або ігнорується. Згідно з опитуванням розробників Stack Overflow 2024, більшість розробників вважають погану або відсутню документацію значним бар’єром для продуктивності. Це не проблема дисципліни. Це проблема інструментів. Внутрішня документація зазнає невдач з конкретних, виправних причин. Інструменти роблять написання болісним. Контент застаріває, бо ніхто не має процесу підтримки його актуальності. Пошук поганий, тому розробники йдуть прямо в Slack. https://valoryx.org/uk/blog/docs-should-be-in-git/ Mon, 09 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/blog/docs-should-be-in-git/ Ось інвентаризація того, що типова інженерна команда тримає в git: Вихідний код додатку Визначення інфраструктури (Terraform, Pulumi, CloudFormation) Конфігурації CI/CD-конвеєрів Скрипти міграції бази даних Специфікації API (OpenAPI, protobuf) Маніфести розгортання (Kubernetes, Docker Compose) Шаблони конфігурації середовища А ось що зазвичай живе поза git: Документація Це дивно. Документація описує систему. Вона змінюється, коли змінюється система. Їй потрібне рецензування, версіонування, атрибуція та можливість відкату. Кожен інший артефакт із цими властивостями живе в git. https://valoryx.org/uk/changelog/v0.5.2/ Sat, 07 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/changelog/v0.5.2/ Інтеграція білінгу Вбудований білінг на базі Stripe. Налаштовуйте тарифні плани, керуйте підписками та обробляйте оновлення безпосередньо з панелі адміністратора. Інтеграція вебхуків Stripe з 5 типами подій Керування життєвим циклом підписок (створення, оновлення, скасування) Облік використання для API-викликів та сховища Генерація рахунків та історія платежів Налаштовувані ліміти тарифу для кожного робочого простору Панель аналітики Відстежуйте ефективність вашої документації за допомогою нової панелі аналітики. Відстеження переглядів сторінок з агрегацією за день, тиждень та місяць Найпопулярніші сторінки та трендовий контент Аналітика пошукових запитів із відстеженням запитів без результатів Метрики залученості користувачів (час на сторінці, глибина прокрутки) Експорт аналітичних даних у CSV ШІ-допомога при написанні ШІ-інструменти для написання, інтегровані безпосередньо в редактор. https://valoryx.org/uk/blog/documentation-as-code/ Thu, 05 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/blog/documentation-as-code/ «Документація як код» — фраза, яку вживають часто. У найпростішому вигляді вона означає ставлення до документації так само, як до вихідного коду: зберігання у системі контролю версій, написання у простому тексті, рецензування через pull request та збірка через CI/CD. Але між ідеєю та її якісною реалізацією є прірва. Цей посібник пояснює, що таке docs-as-code, які підходи існують і де кожен з них має обмеження. Чому docs-as-code важливий Команди розробників вже мають процеси для управління змінами. https://valoryx.org/uk/blog/self-host-docs-5-minutes/ Mon, 02 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/blog/self-host-docs-5-minutes/ Більшість інструментів документації на власному сервері вимагають бази даних, зворотного проксі та половини дня редагування YAML, перш ніж ви побачите екран привітання. DocPlatform — це один бінарний файл на Go без зовнішніх залежностей. Ця інструкція проведе вас від нуля до опублікованої документації приблизно за п’ять хвилин. Передумови Вам потрібен комп’ютер з Linux, macOS або Windows. Це все. Ні Docker, ні PostgreSQL, ні Node.js. DocPlatform компілюється в один статичний бінарний файл — середовище Go вбудоване. https://valoryx.org/uk/blog/notion-alternative-self-hosted/ Sun, 01 Mar 2026 00:00:00 +0000 https://valoryx.org/uk/blog/notion-alternative-self-hosted/ Notion скрізь. Інженерні команди дедалі частіше використовують його для технічної документації. Це працює — до певної межі. Що Notion робить правильно Швидкий гнучкий редактор. Корисні представлення баз даних. Підходить для нетехнічної документації. Де Notion дає збій Немає інтеграції з git. Документи у власній базі даних Notion, відірвані від вашого коду. Розбіжність документації практично неможливо уникнути. Прив’язка до платформи. Експорт у markdown є неохайним. Ваша документація перетворюється на заручника. Лише хмарний варіант. https://valoryx.org/uk/blog/self-hosted-docs-guide/ Fri, 27 Feb 2026 00:00:00 +0000 https://valoryx.org/uk/blog/self-hosted-docs-guide/ Самостійно розгорнута документація переживає справжній підйом. Після того як роки поспіль SaaS-платформи підвищували ціни, змінювали умови та без попередження припиняли роботу, дедалі більше команд обирають власну інфраструктуру документації. Право власності на дані, контроль над витратами, відповідність нормативним вимогам — причини зрозумілі. Але ринок самостійно розгорнутої документації перенасичений. Wiki-платформи, генератори статичних сайтів, бази знань і гібридні інструменти — кожен із власними компромісами. Цей посібник допоможе розібратися у різноманітті варіантів. Що робить платформу документації якісною? https://valoryx.org/uk/blog/gitbook-vs-valoryx/ Wed, 25 Feb 2026 00:00:00 +0000 https://valoryx.org/uk/blog/gitbook-vs-valoryx/ GitBook популярний серед команд розробників. Ми створили Valoryx, щоб вирішити проблеми, які GitBook не розв’язує: право власності на git, self-hosting, прозорість ціноутворення. Досвід роботи в редакторі GitBook: відмінний блоковий редактор, зріла функція спільної роботи. Valoryx: Tiptap WYSIWYG, швидший, чистіший markdown. Висновок: GitBook більш зрілий; Valoryx швидший і забезпечує чистіший markdown. Інтеграція з git GitBook «Git Sync» не є по-справжньому двостороннім — пуші з IDE спричиняють конфлікти злиття. Git-репозиторій НЕ є джерелом істини. https://valoryx.org/uk/blog/why-git-sync-breaks/ Sun, 22 Feb 2026 00:00:00 +0000 https://valoryx.org/uk/blog/why-git-sync-breaks/ Ви підключаєте репозиторій, робите пуш з IDE — і отримуєте конфлікти злиття. Втрачені правки. Тихі відкати. Це фундаментальний дефект проектування. Три способи, якими git sync виходить з ладу 1. Одностороннє дзеркало. Більшість платформ ставляться до git як до резервної копії. Пуші з IDE спричиняють конфлікти. GitBook — найбільш показовий приклад. 2. База даних на першому місці, git — на другому. Wiki.js: база даних є канонічним джерелом. Git — лише однобічний експорт для читання. https://valoryx.org/uk/vs/gitbook/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/vs/gitbook/