Какой способ описания пошагового действия применять при оформлении руководств и/или инструкций - начинать с выполняемого действия или области интерфейса (места), где это действие выполняется?

Приведу свои мысли по этому поводу.

Руководства к оформлению технической документации ИТ-индустрии излагают, что описание действия является более важным. Следовательно, начинать необходимо именно с действия (глагола в повелительном наклонении применительно к русскому языку).

Например,

Нажмите “Кластеры” в левой навигационной панели, затем “Создать кластеры”…

Здесь есть важный момент.

Как заметил в одной из предыдущих заметок, подходы из указанных руководств (гидов по стилю) разрабатывались в основном для англоязычных пользователей и в какой-то мере учитывают психологические аспекты потребителей с “западным” менталитетом.

Хочу сказать следующее.

Применять подходы и лучшие практики необходимо “с головой”. Нельзя просто копировать подходы из гидов по стилю и применять их к “неанглоязычной” аудитории. Это как с кнопкой “купить сейчас” (здесь же “заказать сейчас”, “скачать сейчас” и т.д.). Подобные призывы к действию отлично работают “там”. Но у нас практически не работают. Попробуйте “славянскую душу” (кстати, я бы отнёс сюда всех граждан постсоветского пространства) заставить сделать что-то прямо сейчас (да-да, “Держи карман шире!”). Возникнет только обратная реакция.

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

Поэтому приведенный выше пример я бы немного переделал. Сначала сориентировал бы пользователя в пространстве (указал бы место, куда смотреть), а затем обозначил бы необходимое действие. Вот как-то так:

В левой навигационной панели нажмите “Кластеры”, затем “Создать кластеры”…

Вроде бы мелочь, но именно такие мелочи позволяют составить качественную техническую документацию.