TOPZNANIE

Цифровая практика без сложностей

Выберите город
MET Norway · CC BY 4.0
← На главную

· Инструкции

Как разбить длинную инструкцию на шаги, которые не теряются

Начните с конца: выпишите одной фразой, что человек получит после последнего действия — что будет на экране, в руках или в документе. Затем разделите путь на крупные этапы по смене состояния и оставьте шагом только действие с заметным результатом. Если после действия нельзя остановиться и проверить, что получилось, это ещё не шаг, а половина шага.

С чего начать разбивку длинной инструкции

Самая частая ошибка — резать готовый текст по абзацам и превращать каждое предложение в отдельный шаг. Так появляется список из тридцати строк, где человек не понимает, где он находится и всё ли сделал верно. Абзац — единица текста, а шаг — единица действия, и совпадают они редко.

Сначала зафиксируйте конечный результат. Формулировка должна быть наблюдаемой: «уведомления приходят на почту», «файл открывается в нужной программе», «заказ отображается в списке со статусом оплаты». Слова «настроено» и «готово» не годятся — по ним нельзя проверить, что вы дошли до конца.

Дальше разложите весь путь на крупные этапы по смене состояния: до входа в программу, после входа, после изменения параметров, после проверки. Этапы нужны не читателю, а вам: они показывают, где вообще возможны границы шагов. Внутри каждого этапа уже видно, какие действия дают отдельный результат.

Как понять, где заканчивается один шаг

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

Отдельным шагом обычно становится действие, после которого нужно подождать, перезагрузить программу или перейти в другое место. Проверка почты после отправки тестового письма — самостоятельный шаг, потому что результат появляется не сразу и не там, где вы настраивали.

Ошибка в другую сторону — слишком крупные шаги. «Настройте уведомления» звучит как одна задача, но внутри неё спрятаны выбор канала, ввод адреса и проверка. Человек, который впервые видит программу, на такой формулировке теряется: непонятно, с чего начать и что считать выполнением.

Как сформулировать проверяемый результат шага

Результат пишите тем, что человек увидит: «в списке появился адрес вашей почты», «кнопка стала активной», «в папке появился файл с расширением .pdf». Такой признак читатель сверяет глазами, не обращаясь к вам с вопросом. Общие слова «успешно», «корректно», «правильно настроено» ничего не проверяют — за ними нет наблюдаемого признака.

Если результат проявляется не сразу, укажите, когда и где его искать. Например: письмо может прийти в течение нескольких минут, а если его нет — проверьте папку со спамом. Это не отговорка, а часть проверки: человек знает, куда смотреть и сколько ждать.

Пример. Исходные данные условные: черновик на 40 строк описывает настройку уведомлений в программе. Конечный результат — уведомления приходят на почту. Путь делится на четыре этапа: вход в программу, открытие настроек, выбор канала и ввод адреса, проверка тестовым письмом. После разбивки остаётся 6–8 шагов, и каждый заканчивается тем, что видно на экране или в почтовом ящике. Тридцать строк исчезают не потому, что текст сократили, а потому что перестали считать шагом каждое предложение.

Как расположить шаги, чтобы их не теряли

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

Нумеруйте шаги сквозняком, если инструкцию читают подряд. Новая нумерация в каждом разделе заставляет человека искать, на каком он шаге и не пропустил ли предыдущий. Заголовки этапов при этом остаются: они помогают вернуться к нужному месту, когда инструкцию открывают повторно.

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

Как проверить, что инструкция не рассыпается

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

  • Конечный результат записан одной наблюдаемой фразой.
  • Каждый шаг содержит одно действие и заканчивается проверяемым признаком.
  • Условия и предупреждения стоят перед своим действием.
  • Нумерация сквозная, без перезапуска в новых разделах.
  • Нет шагов без действия и без результата.
  • При чтении подряд не приходится возвращаться назад.

Если на каком-то шаге проверка не срабатывает, не переписывайте всю инструкцию. Вернитесь к этому месту, уточните признак результата или разделите шаг на два — чаще всего этого достаточно. Когда все признаки видны и совпадают с ожиданием, порядок шагов можно считать рабочим.