Дата публикации: .
Летом 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 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 и хлебные крошки, старые ссылки продолжают работать через редирект.
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 делает документацию доступной для 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 теперь ищет и отвечает сразу по всем проектам корпоративной группы, а не только по текущему.
- Появилась возможность видеть, где именно переиспользуются одни и те же блоки контента в разных проектах.
Плюс большой пакет исправлений: PDF-экспорт для крупных проектов, устойчивость редактора при переключении между просмотром и правкой, корректная обработка конфликтов при слиянии веток API-документации.
GitBook — главное здесь: документация становится частью инфраструктуры для AI-агентов, а Content API даёт гораздо больше возможностей для автоматизации.
- MCP-коннекторы подключаются в один клик, а раздел для разработчиков перестроен вокруг MCP как основного сценария.
- Content API позволяет задавать slug страницы при создании и ссылаться на ещё не существующие страницы через временные ссылки.
- Ответ на создание страницы теперь возвращает полный контент и метаданные — это открывает дорогу автоматизированным workflow.
- Поиск по очень большим базам стал быстрее и точнее.
- Краулерам закрыт доступ к AI-эндпоинту, чтобы не тратить впустую краулинговый бюджет.
Из менее заметного — страницы грузят меньше 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 году технический писатель все больше становится проектировщиком опыта, который помогает пользователям решать задачи быстрее, а коллегам — работать эффективнее. Программы для создания справочных систем становятся умнее, но роль человека не уменьшается — она смещается в сторону архитектуры, качества и смысла.