TOPZNANIE

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

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

· Инструкции

Как проверить инструкцию на скрытые допущения: что автор считает очевидным, а исполнитель не знает

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

Какие допущения прячутся в обычной инструкции

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

  • Доступы и права. «Откройте общий диск» — а прав на папку у читателя нет, и запроса на доступ он не увидит.
  • Установленные программы и версии. «Экспортируйте в нужный формат» — а нужный формат есть только в платной версии или появился в позднем обновлении.
  • Ранее выполненные шаги. «Включите синхронизацию» — а вход в аккаунт не описан, и переключатель неактивен.
  • Термины и расположение элементов. «Настройте профиль в разделе параметров» — а раздел называется иначе или спрятан в подменю.

Допущение об «уже настроенном» окружении опаснее пропущенного шага. Пропуск виден по разрыву в последовательности: сделали одно, сразу перескочили к другому. Неявное требование при беглом чтении не видно вовсе — текст выглядит гладким, пока не начнёшь его выполнять.

Как вычитать текст глазами человека без опыта

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

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

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

Пример разбора. Фрагмент: «Откройте настройки и включите синхронизацию как обычно».

«Настройки» — где именно: в программе или в личном кабинете на сайте? «Синхронизация» — какой раздел? «Как обычно» — пропущен вход в аккаунт, без которого переключатель не сработает. Три допущения.

Исправление: «Войдите в аккаунт — понадобятся логин и пароль. Откройте раздел „Синхронизация“ и включите переключатель. Дождитесь статуса „Включено“». Теперь у каждого действия есть условие и проверяемый результат.

Почему «как обычно» и подобные фразы — маркер пропуска

Автор пишет «как обычно», опираясь на собственный опыт: он делал это много раз и не помнит, где именно нажимал. У исполнителя такого опыта нет, поэтому фраза не даёт ни одного действия. Это самый надёжный сигнал остановиться и переписать место.

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

Замена простая: вместо оборота поставьте действие и ожидаемый результат. «При необходимости обновите» превращается в «Проверьте номер версии в разделе „О программе“. Если он ниже указанного, нажмите „Проверить обновления“ и дождитесь сообщения о завершении». Так у читателя появляется критерий, по которому он сам решит, нужен ли шаг.

Куда вынести найденные условия

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

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

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

Финальная проверка опирается на исполнителя, а не на вашу уверенность. Дайте инструкцию человеку без опыта и попросите после каждого шага говорить, что он увидел на экране. Если он называет статус, сообщение или изменившийся элемент — шаг описан достаточно. Если он спрашивает «а что дальше?» или открывает не тот раздел, значит, там осталось допущение. Остановитесь на этом месте и перепишите его, прежде чем двигаться дальше: одна незакрытая догадка ломает всю последовательность.