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

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

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

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

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

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

Инструкции должны быть ясными, полными и недвусмысленными

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

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

Инструкции должны быть основаны на задачах

Хорошо написанные инструкции оставляют пользователя абсолютно без сомнения относительно того, что им нужно делать. В наборе инструкций всегда должно описываться, как выполнять четко определенную задачу. То есть, должна быть какая-то предопределенная цель, которая выполняется. Кроме того, эта цель должна быть понятна читателю, и читатель должен уметь идентифицировать, когда задача будет выполнена. Другими словами, когда они достигают конца инструкций, читатель должен уметь видеть, что ожидаемый результат действительно произошел.

Трудная часть - это то, что составляет задачу. Полезным ориентиром является то, что задачей является «единая работа, выполняемая за один раз, от начала до конца». Таким образом, «Изменение картриджа с принтером» - задача, но «Строительство дома» - нет. Конечно, строительство дома - это добросовестная задача, а не там, где есть учебная документация. При написании инструкций для таких больших задач полезно иметь в виду старый каштан: «Как вы едите слона?». Ответ, конечно же, «Один укус за раз». То же самое и с инструкциями пользователя: если вам нужно проинструктировать читателя о том, как выполнить большую или длительную задачу, переведите задачу в управляемые размеры и затем напишите инструкции для каждого из них.

Для инструкций, связанных с большим количеством отдельных действий, стоит рассмотреть возможность разбить инструкции на несколько меньших наборов инструкций. Основная причина этого заключается в том, что он делает весь набор команд менее сложным для читателя: читатели будут более благоприятно реагировать на 5 наборов 10-шаговых инструкций, чем они будут иметь один набор инструкций с номерами от 1 до. Однако, как указано в «Инструкции должны быть ясными, полными и недвусмысленными» выше, важно, чтобы задачи разделялись в логической точке.

Пример инструкции для пользователей

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

Однако это просто не относится к документации. Существенное различие заключается в том, что с помощью письменных инструкций вы не просите читателя запомнить семь предметов. Читатели, как правило, читают один шаг, выполняют этот шаг, отбрасывают его из кратковременной памяти, читают следующий шаг, выполняют его и т.д. поэтому их просят запомнить ровно одну вещь за раз. Если задача состоит из двадцати задач, то они, вероятно, будут помнить одну вещь за раз, двадцать раз. Поэтому при написании пользовательских инструкций, если задача состоит из 20 последовательных задач без логического деления, тогда есть двадцать задач, пронумерованных от 1 до.

Используйте императивную форму глагола

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

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

• Когда мигает зеленый индикатор, поверните рычаг в положение «Выкл.».
• Если температура поднимается выше 78 градусов Фаренгейта, включите кондиционер.
• Используя гаечный ключ размера 8, затяните гайку.

Требования к квалификации

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

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

В собственном блоге полно контента, текстов, статей, но почему-то посетителей не хватает. И если кто-то потеряется, он быстро исчезнет снова. Если вы посещаете сайт, призрачное чувство распространяется. Компетентности не хватает. Но почему статьи не разделяются и комментируются? Не читай в твиттере об этом, и они тоже не геликсированы?

Научим правильно заполнять формы

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

Шаг - Создайте заголовок

Но как вы пишете такие статьи? Ваш заголовок является одним из наиболее важных элементов вашей статьи в блоге. Ваш заголовок - это первое, что видит ваш читатель. И поскольку в наши дни в нас много бомбардировок, ваш заголовок должен быть чем-то, чтобы выжить.

Шаг - поиск, исследование, исследование

Мне лично нравится «Как спросить женщин в барах» лучше всего. Конечно, нет «идеального курса». Это всегда зависит от контекста и целевой группы. Так что теперь, но достаточно заголовков. Вы не можете все знать. И это нормально. И Себастьян тоже этого не делает? 🙂 И чтобы освежить свои знания по теме, найти разумные источники и не забывать какие-либо детали, вам просто нужно провести исследование. Исследование часто является самым дорогостоящим при публикации новых статей.

Шаг - подумайте о поиске ключевых слов

Что-то поможет вам мой небольшой рабочий процесс. И если вы все сделаете правильно, ваш браузер должен выглядеть примерно так: 🙂. В дальнейшем вам это понадобится как источник. Ваши исследования полны. Теперь вам нужно выполнить поиск по ключевым словам.