Мне кажется, вокруг AI в документации сейчас происходит примерно то же самое, что и вокруг vibe-кодинга.

Появилась куча людей с мыслями: «Ха, теперь вообще не нужны кодеры, ChatGPT/Claude/Deepseek всё сделает сам». А потом внезапно выясняется, что код без понимания архитектуры превращается в весёлый аттракцион «почему оно опять упало».

С документацией ровно та же история. Нейросети действительно очень сильно ускоряют работу, особенно скучную часть: структурирование, разбор черновиков и созвонов, унификацию стиля, оформление, адаптацию под разные аудитории.

Если нормально настроить промты и дать примеры хороших статей — ChatGPT вполне может генерировать базовую инструкцию быстрее человека в несколько раз. И это, честно говоря, прекрасно. Потому что главная проблема большинства баз знаний — не «нейросетевой стиль», как в этом посте.

Главная проблема — что инструкции вообще никто не успевает писать и обновлять. Актуальная и понятная инструкция, написанная с помощью AI, почти всегда лучше, чем идеальная инструкция, которой не существует.

Но вот где начинается веселье: люди почему-то пытаются делегировать нейросети не только написание текста, но и ответственность за факты. И вот это уже плохая идея.

Потому что ChatGPT не знает, как у вас реально работает процесс. Не знает, что Катя из маркетинга по-своему использует корпоративный сленг на созвонах. Или что Валера из разработки только для вида согласился с тимлидом, а сам планирует работать как раньше.

AI очень красиво достраивает вероятный текст.

Именно поэтому нейронка в документации лучше всего работает не как «автор», а как очень быстрый ассистент. Человек всё ещё должен проверять логику, фактчекать, убирать галлюцинации и гарантировать, что инструкция реально помогает решить задачу, а не просто выглядит убедительно.

А стиль, оформление и нейросетевые штампы потом довольно легко правятся руками.

Честно говоря, я вообще не думаю, что через пару лет хороших technical writer’ов станет меньше. Скорее наоборот, и цениться будут уже не тот, кто просто умеет «писать текст», а тот, кто превращает хаос процессов и знаний в понятную, актуальную и работающую систему.

AI тут просто очень быстрый шуруповёрт. Но шкаф всё ещё должен проектировать человек.