Понедельник, 9:17. Февраль 2023, снег с дождём, кофе остывает на подлокотнике. Новичок в чате: «А где пункт про SSO?». В ответ — тишина и PDF на 38 страниц с гордой плашкой «обновлено 2019». В 10:05 мы уже тушили пожары у клиента: технарь нажал не ту галочку, потому что «на картинке синяя, а у меня серая». Через неделю я сел переписать всё с нуля. Итог: было 38 страниц, стало 9 экранов, 14 скриншотов с подсветкой кликов, один чек-лист на финал. Время онбординга — с 6 часов до 3:40, ошибок в первых задачах — минус 27%. И да, больше никто не искал мифический пункт про SSO.
Короткая схема: варим инструкцию, которую реально повторяют
Начинаю с результата, не с поэзии. Одно предложение: «За 15 минут настроите SSO в Okta для трёх команд без простоя». Если вы не можете это сказать — вы ещё не поняли задачу.
Дальше — матчасть в одну «карточку»: что нужно до старта (доступы, версии, роли), где вы делаете шаги (какой раздел интерфейса) и что точно сломается, если промахнётесь. Я пишу это как предупреждения на красной плашке. Страшно? Зато экономит по 40 минут объяснений на человека.
Шаги — только глаголы в повелительном наклонении и один смысл на строку. «Откройте Настройки → Безопасность», «Включите SSO», «Выберите SAML 2.0», «Скачайте метаданные». Ни одного «можно», «желательно», «по желанию». Эти слова — коррозия для действий.
В 2026 скриншоты — не роскошь, а комбинезон безопасности. Я ставлю стрелку ровно туда, куда надо кликнуть, и подписываю не «кнопка справа», а конкретно: «Включить SSO». Где нужно — 10-секундный скринкаст без звука. Никаких 15-минутных «вебинаров» вместо инструкции.
Как звучит один правильный шаг
Глагол — объект — уточнение. «Выберите Шаблон “Корпоративный” → укажите домен компании → нажмите Сохранить». На проверку — мини-орешек: «В строке статуса должно появиться “Verified” в течение 30 секунд». В инструкции без верификации шаг — это гадание по кофейной гуще.
Почему я упираю на эти простые вещи? Потому что пару лет назад мы словили треш-статистику у одного крупного ритейлера: 47 заказов за смену уезжали «в никуда» из‑за неверной сортировки, хотя у сотрудников была «подробная инструкция» на внутреннем портале. Проблема оказалась тупо в формулировках: «Перейдите в модуль Сортировка и убедитесь, что тип отгрузки выбран корректно». Какой тип? Как убедиться? После переписывания на «Откройте Сортировка → выберите Тип: “Региональная” → нажмите Применить → проверьте в правом углу метку “R”» — брак упал на 31% за две недели.
Откуда брать язык, если интерфейс — как подъезд без табличек
Честно: иногда интерфейс настолько упрямый, что инструкция получается сварливой. В такие моменты я иду воровать приёмы у тех, кто годами объясняет сложное простыми действиями — у геймеров. Гайды по билдам, спидран-роуты, патчноуты — там шаги, тайминги и верификация живут как родные. Бывает, заглядываю на games-rus.ru просто посмотреть, как люди раскладывают механику на кнопки и проверочные «сплиты» по времени: взял оттуда идею помечать ветки действий не цифрами, а «ролями» — Админ, Ментор, Исполнитель. После этого в моих инструкциях перестали путаться роли в смешанных командах внедрения.
Ещё один лайфхак я подглядел в гайдах по стратегиям: шаги, где можно облажаться, помечают не красным цветом (глаза быстро устают), а иконкой «череп» в полях. Я адаптировал это в B2B: «Флажок риска» — маленький треугольник с восклицательным знаком на полях инструкции. За март 2024 у одного знакомого из логистической компании количество критичных ошибок в окне «закрытия смены» упало с 19 в неделю до 6, когда они добавили такие флажки в три шага.
Ещё трюк: версия. В гейм-патчноутах версия — король. Я теперь ставлю версию прямо в заголовок инструкции и прошиваю её в скриншотах. К середине 2025 это избавило нас от споров «у меня не так выглядит» на 43% обращений в саппорт: люди видят, что их UI — 2.11, а инструкция — 2.9, и идут обновляться, не звоня никому.
Редактура ножом: вырезать лишнее, добавить контроль и измерения
Первый проход я делаю на диктофоне: читаю шаги вслух, как бы объясняя коллеге через плечо. Там чудесно слышны паразиты: «затем», «далее», «как правило». Я режу их без жалости. Вместо «затем» — точка и новый шаг. Вместо «как правило» — конкретное условие с цифрами: «если билетов больше 200, разбейте на партии по 50».
Затем прогон через «читателя-незнакомца». В июне 2025 я позвал на ревью сына друга, студент-первокурсник, который никогда не видел наш продукт. Поставил таймер на 20 минут и дал инструкцию по настройке вебхуков. Он стопорился на двух местах: «непонятно, куда смотреть после отправки теста» и «где искать логи». Это были мои «слепые зоны». Добавили блок «Как убедиться, что всё работает» и ссылку на раздел логов из шага. Время прохождения упало с 19:30 до 12:40 без чьей‑то помощи.
Мерить нужно не впечатления от инструкции, а прохождение. Я считаю: среднее время по шагу, процент пользователей, застрявших больше чем на 90 секунд на одном экране, долю возвратов к предыдущему шагу. После июльского обновления 2025 у нас был пик возвратов на шаг 4 — 58%. Оказалось, скриншот был старый на один релиз: кнопка уехала на соседнюю вкладку. Обновили — возвраты упали до 11% за двое суток.
Про формат. В 2026 ИИ-подсказчики стали неплохой «рыбой», но черновик без человека — опасный яд. Модель выдумывает поля, которых нет, или путает порядок. Мой рецепт: да, генерируйте скелет, но все глаголы, объекты и скриншоты — руками. И всегда — «контрольный орешек» после каждого смыслового блока, иначе люди как будто читают, но не понимают, сделали ли правильно.
Чек-лист перед публикацией (короткий, без бюрократии)
— Есть цель в одном предложении и версия инструкции.
— У каждого шага — глагол, объект, уточнение; нет «можно/желательно».
— В каждом блоке — проверка результата, которую можно сделать за минуту.
— Скриншоты с подсветкой кликов, не больше 2–3 на шаг; есть 10-секундный скринкаст, если действие сложно показать статикой.
— Предупреждения и «флажки риска» стоят у мест, где чаще всего ошибаются.
— Прогон на «читателе-незнакомце» и метки, где он зависал.
И последнее — подача. Инструкция — это не утренник для начальства и не роман в письмах. Это бытовой инструмент, как отвёртка на 6 мм. Он должен лежать под рукой, подходить к винту и не резать пальцы. Всё остальное — мишура. Когда выбираете между ещё одним абзацем «пояснений» и маленьким тестом «На экране “Интеграции” видите зелёный статус?», выбирайте тест. Люди приходят в инструкции, чтобы выйти из них с действием, а не с мнением.
