TOPZNANIE

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

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

· Инструкции

Названия кнопок и файлов в инструкции: как писать, чтобы исполнитель нашёл их без догадок

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

Почему пересказ названия кнопки своими словами ломает выполнение

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

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

Проверяйте похожие элементы. В одном окне могут стоять «Сохранить» и «Сохранить как» — это разные действия, а пересказ «сохраните файл» их смешивает. Если подходящих надписей несколько, укажите, где нужная: в каком окне, вкладке или области.

Как отделять названия элементов от обычного текста без сложной вёрстки

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

Главное правило: выделенное всегда читается как надпись с экрана, невыделенное — как речь автора. Тогда исполнитель сразу видит, что искать. Проверка: уберите выделение мысленно — смысл фразы не изменится, а поиск элемента станет труднее.

Не превращайте выделение в украшение. Если полужирным отмечены и названия, и предупреждения, и важные мысли, оно ничего не значит. Предупреждения пишите отдельной фразой.

В черновике: «нажмите кнопку сохранения и откройте папку с отчётами». Находим на экране надпись «Сохранить» и подставляем её. Путь записываем цепочкой: «Документы → Отчёты». Итог: «Нажмите Сохранить, затем откройте папку «Документы → Отчёты»». Исполнитель ищет буквальную надпись и идёт по папкам по шагам.

Что делать, если в разных версиях программы названия отличаются

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

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

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

Как указывать путь к файлу и папке, чтобы его можно было найти

Путь записывайте последовательно, от общего к частному, разделяя шаги стрелкой: «Документы → Отчёты → май.xlsx». Человек повторяет шаги по порядку и доходит до места без вопросов. Имя файла отделяйте от пути и берите в кавычки.

Не сокращайте путь до одного имени папки, если таких папок несколько. «Откройте папку „Отчёты“» не поможет, когда «Отчёты» есть и на рабочем столе, и внутри «Документов». Начало цепочки задаёт точку отсчёта и снимает догадки.

Если файл нужно создать, укажите и место, и имя: где сохранять и как назвать. Иначе исполнитель сохранит результат в первую попавшуюся папку, и следующий шаг снова потребует поиска.

Проверка: поиск по инструкции всех названий и сверка с экраном

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

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

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