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