ИИ в его самых разных проявлениях уже стал частью работы с документацией (да и вообще со всем и везде как будто).
Мы уже готовим драфты, генерим примеры, анализируем код (что не отвлекать разработчиков и прокачиваться самим), работаем со структурой текстов. А еще проверяем покрытие продукта документацией, соответствие текстов внутренним стайлгайдам, вычищаем артефакты от старых движков и дорабатываем текущий движок. Эти сценарии уже отработаны и стали вполне привычными.
Но важно понимать, изменился не только набор инструментов, но и контекст, в котором используется документация. Теперь документация - источник данных для ИИ. Если пользователь взаимодействует с продуктом через ИИ-агентов, ответы этих систем зависят от структуры, согласованности и актуальности документации.
В таком контексте требования к контенту становятся более явными. Важно, чтобы:
- термины использовались последовательно
- между информацией в разных разделах не было противоречии
- структура документации позволяла однозначно интерпретировать информацию
- информация всегда оставалась актуальной, не было легаси-данных
Да, эти требования и раньше учитывались в работе над документацией, но из-за особенностей обработки информации с помощью ИИ они стали еще важнее. Теперь трансформируется сама роль специалистов, которые создают документацию. На первый план выходит работа со структурой знаний и формирование контекста для ИИ: определение связей между сущностями, контроль терминологии, поддержание согласованности и полноты информации.
Конечно, не стоит романтизировать применение ИИ-инструментов как универсальное решение всех проблем. В первую очередь задачу решает человек, а ИИ - это только инструмент.
(Картинки с выставки в МАММ вполне в тему, про выставку напишу чуть позже)
Увидимся на TechWriter Days уже в пятницу, 27 марта
