Как написать инструкцию: определить цель и результат, разбить процесс на шаги (один шаг — одно действие), описать каждый шаг коротко и однозначно, добавить скриншоты к ключевым местам, проверить на реальном человеке и обновлять при изменении процесса. Ниже — пошаговый метод и правила, которые делают инструкцию понятной и пригодной к использованию.
Что такое хорошая инструкция
Инструкция — это пошаговое описание действий, которое позволяет человеку без предварительного опыта выполнить задачу и получить нужный результат. Хорошая инструкция не предполагает, что читатель «догадается»: каждый шаг явно указывает, что сделать, куда нажать или что ввести.
Критерии качества:
Один шаг — одно действие. Не «откройте настройки и выберите уведомления», а шаг 1 — «откройте настройки», шаг 2 — «выберите раздел „Уведомления“».
Порядок шагов совпадает с порядком действий. Читатель идёт сверху вниз и не возвращается назад за уточнениями.
Нет двусмысленности. Названия кнопок, пунктов меню и полей приведены так, как они отображаются в интерфейсе.
Есть визуальная опора. Скриншоты или схема к тем шагам, где легко ошибиться или потеряться.
Инструкция пишется под конкретную задачу и аудиторию: для новичка — больше пояснений, для опытного пользователя — можно короче, но без пропусков критичных шагов.
Как написать инструкцию: пошаговый метод
Шаг 1. Сформулировать цель и результат
Ответьте на два вопроса: что должен уметь читатель после прохождения инструкции и какой итог считается успешным. Например: «После инструкции пользователь сможет привязать карту к аккаунту»; результат — «карта привязана, списание возможно». Цель задаёт границы: не нужно описывать всё про оплату, только привязку карты.
Если инструкция для коллег или клиентов — уточните, кто читатель и какой у него уровень доступа (роль в системе, права). От этого зависит, какие шаги включать и что пояснять.
Шаг 2. Пройти процесс сами и зафиксировать действия
Выполните задачу от начала до конца и записывайте каждое действие: куда зашли, что нажали, что ввели. Не полагайтесь на память — в реальном процессе часто есть нюансы (всплывающее окно, лишний клик, обязательное поле). Удобно проходить процесс с записью экрана или инструментом, который фиксирует действия в интерфейсе: так вы получаете заготовку инструкции и не пропускаете шаги.
На этом этапе важно фиксировать текущий процесс («как есть»), а не идеальный. Правки и оптимизацию можно сделать после того, как инструкция будет записана.
Шаг 3. Разбить на шаги: одно действие на шаг
Превратите запись в последовательность шагов. Правило: один шаг = одно однозначное действие. Если в одном предложении «откройте меню, выберите пункт и нажмите „Сохранить“» — разбейте на три шага. Так читатель не путается и легко находит место, на котором застрял.
Нумеруйте шаги. Начинайте формулировку с глагола в повелительном наклонении: «Откройте…», «Нажмите…», «Введите…», «Выберите…». Избегайте длинных абзацев внутри шага — при необходимости добавьте короткое пояснение отдельной строкой под действием.
Шаг 4. Добавить скриншоты к ключевым шагам
Скриншоты нужны там, где читатель должен что-то найти на экране: кнопка, меню, форма, сообщение об успехе. Сделайте скриншот актуального интерфейса, выделите нужный элемент (стрелка, рамка, подчёркивание) и подпишите, что это. Один скриншот — один шаг или один экран; не объединяйте несколько действий в одну картинку без пояснения.
Если интерфейс часто меняется — укажите в инструкции, кто и когда обновляет скриншоты, иначе текст и картинки быстро разойдутся.
Шаг 5. Указать условия и возможные варианты
В начале инструкции кратко укажите что нужно иметь (доступ, права, данные) и откуда начинать (например: «Вы находитесь в личном кабинете, раздел „Настройки“»). Если процесс различается в зависимости от выбора (например, «оплата картой» и «оплата со счёта») — опишите ветки явно: «Если вы выбрали карту — перейдите к шагу 5; если счёт — к шагу 8», или оформите отдельные блоки/подзаголовки.
Предупредите о типичных ошибках или последствиях, если это важно: «После нажатия „Отправить“ заявку нельзя будет отредактировать».
Шаг 6. Проверить на реальном человеке
Дай инструкцию тому, кто задачу раньше не выполнял (коллега, тестовый пользователь). Не подсказывайте — пусть идёт только по тексту и скриншотам. Отметьте, на каком шаге возникли вопросы, где человек нажал не туда или не нашёл элемент. По результатам упростите формулировки, разбейте сложные шаги или добавьте скриншот.
Одна проверка уже сильно повышает качество: вы замечаете пропуски и неочевидные формулировки.
Шаг 7. Назначить ответственного за обновление
Инструкция устаревает, когда меняется интерфейс, процесс или роли. Закрепите, кто проверяет и обновляет её при таких изменениях (релиз, смена процесса, обратная связь от поддержки). Без ответственного документ через несколько месяцев может вводить в заблуждение.
Рекомендуется указывать в конце инструкции дату последнего обновления или версию — так проще понять, актуальна ли она.
Правила написания инструкции: краткий чек-лист
Один шаг — одно действие. Не объединяйте несколько действий в один пункт.
Глагол в начале шага. «Откройте», «Нажмите», «Введите», «Выберите».
Точные названия элементов. Как в интерфейсе: «Кнопка „Сохранить“», «Поле „Email“».
Скриншоты к местам, где легко ошибиться. Актуальные, с выделением нужного элемента.
Условия в начале. Что нужно иметь и откуда начинать.
Ветвления явно. «Если А — шаг X, если Б — шаг Y».
Проверка на новичке. Хотя бы один проход без подсказок.
Ответственный за обновление. И дата/версия в конце.
Частые ошибки при написании инструкции
Слишком крупные шаги. «Настройте учётную запись» — не шаг, а целый процесс. Разбейте на конкретные действия.
Пропуск «очевидных» шагов. То, что кажется очевидным автору, может быть неочевидным читателю. Лучше добавить один лишний шаг, чем потерять пользователя на полпути.
Устаревшие скриншоты. Интерфейс изменился — инструкция вводит в заблуждение. Привяжите обновление скриншотов к релизам или изменениям процесса.
Нет проверки на реальном человеке. Текст может быть понятен только тому, кто уже знает процесс. Один тест выявляет большинство проблем.
Смешение нескольких задач в одной инструкции. «Как зарегистрироваться и настроить профиль и привязать карту» — лучше три отдельные инструкции с перекрёстными ссылками.
Короче говоря:
Чтобы написать инструкцию: сформулируйте цель и результат, пройдите процесс и зафиксируйте действия, разбейте на шаги (один шаг — одно действие), добавьте скриншоты к ключевым местам, укажите условия и ветвления, проверьте на человеке без опыта и назначьте ответственного за обновление. Хорошая инструкция не требует догадок: каждый шаг однозначен, порядок действий совпадает с порядком чтения, есть визуальная опора. Избегайте крупных шагов, пропусков «очевидного» и устаревших скриншотов.
Steppo: запись действий в браузере превращается в пошаговую инструкцию со скриншотами — удобно для написания и обновления гайдов.