Как проверить инструкцию на скрытые допущения: что автор считает очевидным, а исполнитель не знает
Прочитайте инструкцию по одному действию и после каждого шага спросите: что нужно уже иметь или знать, чтобы его выполнить. Всё, на что нет ответа в тексте, — скрытое допущение. Выпишите его и превратите в явное условие: доступ, программу, предыдущий шаг или расшифровку термина. Проверка закончена, когда исполнитель проходит инструкцию, ни разу не додумывая действие.
Какие допущения прячутся в обычной инструкции
Скрытое допущение — требование, которое автор не назвал, потому что для него оно само собой разумеется. Исполнитель же упирается в него и не понимает, где застрял. Искать стоит четыре группы.
- Доступы и права. «Откройте общий диск» — а прав на папку у читателя нет, и запроса на доступ он не увидит.
- Установленные программы и версии. «Экспортируйте в нужный формат» — а нужный формат есть только в платной версии или появился в позднем обновлении.
- Ранее выполненные шаги. «Включите синхронизацию» — а вход в аккаунт не описан, и переключатель неактивен.
- Термины и расположение элементов. «Настройте профиль в разделе параметров» — а раздел называется иначе или спрятан в подменю.
Допущение об «уже настроенном» окружении опаснее пропущенного шага. Пропуск виден по разрыву в последовательности: сделали одно, сразу перескочили к другому. Неявное требование при беглом чтении не видно вовсе — текст выглядит гладким, пока не начнёшь его выполнять.
Как вычитать текст глазами человека без опыта
Представьте исполнителя, который видит программу впервые и не знает ваших привычек. Пройдите инструкцию по одному действию и после каждого задайте три вопроса: где взять, чем открыть, под каким именем искать. Ответ «понятно же» означает, что допущение найдено.
Отмечайте каждое существительное-инструмент: файл, аккаунт, папка, программа, ключ доступа. Рядом с ним должно стоять, откуда он берётся. Отдельно проверяйте глаголы доступа: «войдите», «подключите», «предоставьте права» — все они требуют данных, которых у новичка может не быть.
Смотрите, названы ли точные места: пункт меню, поле, кнопка. Фраза «в соответствующих настройках» оставляет читателю догадку, а догадка — источник ошибок. Хороший признак: по тексту можно пройти, не открывая ничего лишнего и не спрашивая коллегу.
Пример разбора. Фрагмент: «Откройте настройки и включите синхронизацию как обычно».
«Настройки» — где именно: в программе или в личном кабинете на сайте? «Синхронизация» — какой раздел? «Как обычно» — пропущен вход в аккаунт, без которого переключатель не сработает. Три допущения.
Исправление: «Войдите в аккаунт — понадобятся логин и пароль. Откройте раздел „Синхронизация“ и включите переключатель. Дождитесь статуса „Включено“». Теперь у каждого действия есть условие и проверяемый результат.
Почему «как обычно» и подобные фразы — маркер пропуска
Автор пишет «как обычно», опираясь на собственный опыт: он делал это много раз и не помнит, где именно нажимал. У исполнителя такого опыта нет, поэтому фраза не даёт ни одного действия. Это самый надёжный сигнал остановиться и переписать место.
Другие обороты того же рода: «стандартным способом», «при необходимости», «уже настроенный», «соответствующие права», «в обычном порядке». Каждый из них скрывает либо пропущенный шаг, либо условие, либо выбор, который автор сделал за читателя молча.
Замена простая: вместо оборота поставьте действие и ожидаемый результат. «При необходимости обновите» превращается в «Проверьте номер версии в разделе „О программе“. Если он ниже указанного, нажмите „Проверить обновления“ и дождитесь сообщения о завершении». Так у читателя появляется критерий, по которому он сам решит, нужен ли шаг.
Куда вынести найденные условия
Предварительные требования ставьте в начало, до первого шага: доступы, установленные программы с версиями, исходные файлы, права на папку. Всё, что нужно до старта, читатель должен увидеть раньше, чем начнёт действовать, иначе он дойдёт до середины и упрётся в стену.
Условия, относящиеся к конкретному шагу, оставляйте рядом с этим шагом. Если вход в аккаунт нужен только для синхронизации, не надо тащить его в общий список — поставьте прямо перед действием. Так читатель не держит в голове лишнего и видит причину требования в нужный момент.
- Выпишите все найденные допущения отдельным списком, до правки текста.
- Разделите их на предварительные и шаговые.
- Каждое переформулируйте в действие с проверяемым результатом.
- Попросите исполнителя пройти инструкцию и назвать, что ему пришлось додумать.
- Закройте названные пробелы и повторите проход.
Финальная проверка опирается на исполнителя, а не на вашу уверенность. Дайте инструкцию человеку без опыта и попросите после каждого шага говорить, что он увидел на экране. Если он называет статус, сообщение или изменившийся элемент — шаг описан достаточно. Если он спрашивает «а что дальше?» или открывает не тот раздел, значит, там осталось допущение. Остановитесь на этом месте и перепишите его, прежде чем двигаться дальше: одна незакрытая догадка ломает всю последовательность.