У документации появился второй читатель, и ему не нужны меню

У любой справочной системы долгое время был один читатель — человек. Для него придумывали оглавления, хлебные крошки, поиск, кнопки «Следующая страница». Всё это работает как вывески в торговом центре: помогает быстро сориентироваться тому, кто идёт по коридорам своими ногами.

Теперь у документации есть второй читатель. Пользователь всё чаще не открывает справку сам, а спрашивает у ИИ-ассистента: «Как настроить выгрузку отчёта?» или «Почему не приходит уведомление?». Ассистент идёт в документацию вместо человека. И для него вывески торгового центра бесполезны. Он похож на курьера, которому нужен не красивый вход, а точный адрес и опись содержимого посылки.

Когда ИИ-агент открывает обычную страницу справки, он получает её целиком: меню, панель навигации, кнопки, футер, служебные элементы. Полезный текст лежит где-то посередине, как письмо в конверте, набитом рекламными листовками. Агент может его найти, а может и перепутать: принять пункт меню за часть инструкции или ответить по соседней странице. Пользователь получит неточный ответ и решит, что в документации ничего нет.

В ноябрьском обновлении Документерры мы занялись именно этим вторым читателем. Порталы теперь помогают ИИ-агентам находить открытую документацию и получать только содержимое страниц, без меню и кнопок. Настраивать для этого ничего не нужно: портал сам показывает агенту, где лежит документация и как её прочитать.

Важно, что это не открывает агентам больше, чем нужно. Курьер получает доступ только к тем посылкам, которые ему можно забрать. Что видно агентам, определяют настройки видимости публикаций: закрытая документация остаётся закрытой. А файл robots.txt по-прежнему подсказывает поисковым роботам, какие страницы обходить, а какие нет.

Есть и следующий шаг. Если на портале включён MCP-сервер опубликованной документации, читатель может подключить свой ИИ-ассистент напрямую к вашей документации. Тогда ассистент не ищет ответ по всему интернету, а работает с вашими страницами, как сотрудник, у которого на столе лежит актуальная инструкция, а не пересказ из третьих рук.

Для компаний это вопрос не моды, а того, насколько точно их продукт объясняют клиентам. Если документацию плохо видно ИИ-инструментам, ассистент ответит по старой статье на форуме или додумает недостающее. Если видно хорошо — ответ будет основан на том, что написала ваша команда.

В том же обновлении есть изменения и для тех, кто документацию пишет. Перед заменой файла или удалением проекта можно за пару секунд узнать, какие страницы на него ссылаются, даже на больших порталах. В новом шаблоне читательского интерфейса Next работают почти все настройки классических шаблонов и несколько новых. А группами доступа к закрытой документации теперь можно управлять через API и связать их с CRM или системой подписок.

Подробнее обо всех изменениях — в описании обновления.