Background

Обзор программ для создания документации: что нового в августе 2026

Иван Давыдов

Дата публикации: .

Летом 2026 года появилось немало поводов написать обзор инструментов для создания документации — разработчики выпустили массу интересных обновлений. Можно выделить два тренда — интерактивная API-документация и встраивание AI в рабочие процессы. При этом одни продукты делают ставку на глубокую техническую функциональность для опытных разработчиков (Document360), другие — на доступность для нетехнических специалистов (Zendesk, iSpring). Третьи, как ClickHelp, развивают AI-инфраструктуру для читателей.

Предлагаем обзор ключевых летних обновлений 2026 года и выводы, которые из них можно сделать.

Document360 v12.8.1: API-документация становится средой разработки

В августе разработчики Document360 выпустили релиз v12.8.1, переработавший страницы API reference. Теперь это интерактивная среда, где описание API дополняется возможностью тестировать запросы.

Что появилось:

  • Перестроенная консоль Try It! — трехпанельный интерфейс: слева описание метода API, в центре редактор запроса с контролем над параметрами, заголовками и содержимым запроса, справа — ответ сервера. Авторизация для защищенных методов проходит прямо в консоли.
  • Валидация схемы в реальном времени — ошибки в содержимом запроса подсвечиваются в процессе ввода.
  • Переменные уровня сессии — значение сохраняется один раз и используется во всех методах, что упрощает тестирование связанных вызовов.
  • Встроенный Eddy AI — читатели задают вопросы о методе API на той же странице: как устроена авторизация, что означает тот или иной параметр. AI отвечает в контексте документации, не отвлекая пользователя на поиск ответов.
  • Начало внедрения Widget 2.0 — новая архитектура для встраивания документации в сторонние сайты. Пока доступна для тестирования и миграции по запросу.

API-документация перестает быть "текстом про API" и превращается в рабочий инструмент. Автор может следить не только за точностью описаний, но и за тем, чтобы примеры запросов были работоспособны. Новые возможности пока доступны не всем сразу: сначала для новых проектов, затем для действующих.

обновление Document360

Document360 v12.8.2: API v3 и управляемый AI

Неделей спустя вышел v12.8.2. Если в версии 12.8.1 речь шла о том, как читатель взаимодействует с API-справочником — через интерактивную консоль и AI-помощника прямо на странице, — то этот релиз меняет архитектуру интеграций и права доступа.

Что появилось:

  • API v3 — полностью переработанная версия REST API с расширенным набором методов для управления контентом, пользователями, ролями, доступом читателей, файловым хранилищем и аналитикой. Для подключения сторонних приложений добавлен OAuth 2.0. Интеграции и скрипты теперь работают через ключи API с ограниченной областью действия с четко прописанными правами: кто управляет порталом, кто редактирует контент и какие разделы базы знаний доступны через конкретный ключ. Старые версии API v1/v2 продолжают работать без изменений.
  • Управление доступом к Eddy AI по группам читателей — администратор может ограничить доступ к AI-функциям (поиск Ask Eddy, краткое изложение статей, рекомендации, MCP-сервер, озвучивание текста) для отдельных групп читателей. Для остальных групп доступ сохраняется по умолчанию.
  • Обновленный Smart bar — переработан интерфейс создания Smart bar: предпросмотр в реальном времени, панель редактирования, выбор языка, пакетные операции, дублирование.
  • Ticket deflector переименован в Get help — изменены URL и хлебные крошки, старые ссылки продолжают работать через редирект.

обновление Document360

API v3 меняет подход к интеграции Document360 с внешними системами: вместо универсального ключа теперь можно настраивать права доступа. Технический писатель, который администрирует базу знаний, получает возможность документировать не только пользовательский контент, но и модель доступа. А управление доступом к Eddy AI добавляет гибкости: AI больше не включен для всех по умолчанию. Если в одном проекте работают внутренние сотрудники и внешние клиенты, администратор может заранее настроить, кому доступен умный поиск, а кому — нет. Это расширяет задачу техписа: от "написания текста" до "проектирования опыта читателя с учетом его роли".

Что это значит для техписа на практике. Теперь вы можете создавать документацию, которую разработчик тестирует прямо на странице справочника, не переключаясь в отдельную программу для тестирования API. Вы можете настраивать, каким группам читателей доступен AI-поиск, а каким — нет.

ClickHelp: AI-инфраструктура для читателей и подписки на изменения

В августе 2026 года ClickHelp выпустил релиз, который меняет подход к тому, как читатели взаимодействуют с документацией. Вместо того чтобы встраивать AI в интерфейс, ClickHelp позволяет читателям подключать свои собственные AI-агенты к опубликованной документации.

Что появилось:

  • Published Docs MCP Server — читатели могут подключать AI-агентов (Claude, Cursor, ChatGPT, Gemini) напрямую к опубликованной документации. Агент читает актуальный опубликованный контент и отвечает на основе того, что написано в документации. Агент видит то же, что и анонимный посетитель — только публичные материалы, без доступа к ограниченному контенту или неопубликованным проектам. Администратор может полностью отключить эту возможность. Подробнее — в документации Published Docs MCP Server.
  • AI Overview в поиске — читатель задает вопрос в поиске и получает ответ, сгенерированный на основе документации, прямо в результатах поиска. Можно задавать уточняющие вопросы, не покидая поиск. Это работает на существующих настройках AnswerGenius — ничего не нужно настраивать заново. Подробнее — в документации AI Overview in search results и AnswerGenius.
  • Подписка на изменения — Power Readers могут подписаться на тему или целую публикацию и получать email при изменении контента. Любой читатель (авторизованный или нет) может открыть "Topic changes" и увидеть, чем текущая версия отличается от предыдущей. Подробнее — в документации Notifications for Power Readers и Reader interface settings.
  • Улучшенный Quick Publish — перед публикацией отображается полный список тем, которые войдут в публикацию.

обновление Clickhelp

ClickHelp делает документацию доступной для AI-экосистемы, но принципиально иначе, чем Document360. Document360 встраивает AI в свой интерфейс (консоль Try It!, Eddy AI). ClickHelp, напротив, отдаёт документацию внешним AI-агентам через MCP-сервер — читатель может использовать тот AI-инструмент, к которому привык. Это меняет подход технического писателя: теперь нужно уделять внимание не только тому, как читатель будет искать информацию в интерфейсе, но и тому, как AI-агент будет её находить и интерпретировать.

Dr.Explain не остался в стороне и внедрил ИИ-ассистента, подробнее об этом можно узнать на странице истории версий.

Рекомендуем ознакомиться со статьями, посвященными ИИ:

Создатели облачных решений также предложили ряд нововведений.

Обновления в SaaS-платформах: AI-инфраструктура и интеграция с разработкой

Помимо классических HAT-инструментов и редакторов, летом 2026 года произошли значимые обновления в облачных платформах для создания документации. SaaS-решения внедряют искусственный интеллект: AI встраивается в архитектуру, а интеграция с разработкой становится стандартом.

Paligo: Next Gen Editor и AI Translations

В марте 2026 года разработчики Paligo анонсировали крупный релиз:

  • Next Gen Editor — структурированный контент без необходимости знать XML.
  • AI Translations — перевод прямо внутри CCMS.
  • AI Assistant — помощь в написании.

Paligo делает компонентное управление контентом доступным для авторов без технического опыта, а AI-перевод встраивается в рабочий процесс.

Другие SaaS-платформы

ReadMe — в очередном обновлении добавили точечный контроль аналитики и расширили AI-поиск для крупных проектов.

  • Из статистики по документации можно исключать трафик по домену почты, чтобы просмотры сотрудников не искажали данные.
  • Поиск стал точнее находить составные термины по части слова.
  • Ask AI теперь ищет и отвечает сразу по всем проектам корпоративной группы, а не только по текущему.
  • Появилась возможность видеть, где именно переиспользуются одни и те же блоки контента в разных проектах.

обновление SaaS-платформы ReadMe

Плюс большой пакет исправлений: PDF-экспорт для крупных проектов, устойчивость редактора при переключении между просмотром и правкой, корректная обработка конфликтов при слиянии веток API-документации.

GitBook — главное здесь: документация становится частью инфраструктуры для AI-агентов, а Content API даёт гораздо больше возможностей для автоматизации.

  • MCP-коннекторы подключаются в один клик, а раздел для разработчиков перестроен вокруг MCP как основного сценария.
  • Content API позволяет задавать slug страницы при создании и ссылаться на ещё не существующие страницы через временные ссылки.
  • Ответ на создание страницы теперь возвращает полный контент и метаданные — это открывает дорогу автоматизированным workflow.
  • Поиск по очень большим базам стал быстрее и точнее.
  • Краулерам закрыт доступ к AI-эндпоинту, чтобы не тратить впустую краулинговый бюджет.

обновление SaaS-платформы GitBook

Из менее заметного — страницы грузят меньше JavaScript на старте, а экспорт в GitHub теперь проверяет размер файлов на лимит.

Mintlify — в этом релизе фокус на совместной работе в редакторе и на расширении интеграций для AI-агентов.

  • Добавили поддержку Bitbucket Cloud как Git-провайдера для Enterprise.
  • История версий в редакторе сгруппирована по датам, появились автокоммиты при наборе текста.
  • Создание веток ускорилось, можно переносить несохранённые правки при переключении между ветками.
  • Приватные страницы получили собственную историю версий и уведомления.
  • Интеграции со Stripe, Notion и Zendesk дают AI-агенту доступ к бизнес-контексту за пределами самой документации.

Также доработали поиск по точным совпадениям идентификаторов и добавили автоматический редирект посетителя на предпочитаемый язык браузера.

У всех трёх платформ в этом цикле обновлений один и тот же вектор: документация перестаёт быть контентом только для человека и превращается в источник данных для AI-агентов. GitBook выносит MCP на первый экран, ReadMe расширяет Ask AI до поиска по всей корпоративной группе проектов, а Mintlify подключает агентам внешние бизнес-системы вроде Stripe и Zendesk — то есть агент должен уметь не просто прочитать статью, а собрать ответ из нескольких источников сразу. Параллельно углубляется docs-as-code: у GitBook — программируемый Content API с поддержкой ещё не созданных страниц, у Mintlify — автокоммиты и работа с ветками почти как в обычном репозитории кода. Для техписа это значит, что структура контента (чёткие идентификаторы, переиспользуемые блоки, разметка, которая однозначно парсится) становится не менее важной, чем сам текст — потому что читать эту документацию будет не только пользователь, но и модель, которая должна из неё что-то извлечь. А при выборе платформы для своей команды вопрос всё чаще звучит не "умеет ли она публиковать мануалы" — это давно решено везде — а "умеет ли она отдавать контент и человеку, и AI-агенту одинаково надёжно и на масштабе".

Обновления лета 2026 года показывают два разнонаправленных, но одинаково сильных тренда:

Тренд Примеры Суть
Интерактивность и техническая глубина Document360 (Try It! консоль, валидация, Eddy AI) Документация превращается в среду для работы, а не просто в справочник.
AI-инфраструктура для читателей ClickHelp (MCP Server, AI Overview в поиске), Paligo (AI Translations) Документация становится доступной для AI-экосистемы — читатели подключают свои AI-агенты, а поиск выдаёт готовые ответы.

Эти тренды возникли в ответ на конкретные запросы пользователей. Разработчики хотят тестировать API в документации, не переключаясь между вкладками. Читатели хотят получать ответы на вопросы без поиска по страницам — либо через AI-поиск, либо через собственных AI-агентов. Эти потребности никуда не исчезнут в ближайшие годы, поэтому направления развития, выбранные ведущими продуктами, будут сохраняться.

В 2026 году технический писатель все больше становится проектировщиком опыта, который помогает пользователям решать задачи быстрее, а коллегам — работать эффективнее. Программы для создания справочных систем становятся умнее, но роль человека не уменьшается — она смещается в сторону архитектуры, качества и смысла.


Смотрите также