Импортозамещение документации: почему перенос страниц — не то же самое, что перенос процесса
CNews в обзоре «Рынок ИТ: итоги 2025» отмечает: российский ИТ-рынок переходит от срочного импортозамещения к более осознанному выбору — заказчики теперь оценивают не только факт замены продукта, но и устойчивость, безопасность, интеграции и экономический результат решения.
В документации происходит то же самое.
Несколько лет назад задача была простой: уйти от зарубежной системы и не потерять материалы. Многие её решили — перенесли страницы в российскую базу знаний, в Git со статическим генератором или в собственную сборку из нескольких инструментов.
Но миграция страниц и миграция процесса — разные вещи. Вместе со старой системой часто теряются:
— переиспользование контента (одна инструкция вместо десяти расходящихся копий);
— работа с несколькими версиями продукта без ручного дублирования;
— условный контент и права доступа;
— управляемая сборка вместо самописных скриптов.
Проявляется это не сразу, а через год-два — когда объём документации растёт, а команда тратит всё больше времени на обслуживание системы, а не на содержание документации.
В статье — как отличить три разных уровня проблемы (процесс, внедрение, архитектура), почему это разные диагнозы с разным лечением, и почему подключение ИИ-помощника к базе знаний не исправляет устаревшие или противоречивые материалы, а лишь озвучивает их уверенным тоном.