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