ОБЗОР Чтобы создать эффективный пользовательский документ, автор должен знать, для кого он пишет. В этой статье представлены четыре измерения (навыки, отношение, знания и опыт) для описания пользователя вашего продукта (вашего читателя документации), а также способы создания Персоны, которая превратит вашего обычного Пользователя в почти реального человека.
В статье подчеркивается необходимость ИСПОЛЬЗОВАТЬ эту информацию при структурировании и написании вашего Пользовательского документа.
ПОЛУЧЕНИЕ ИНФОРМАЦИИ О ВАШЕМ ПОЛЬЗОВАТЕЛЕ Отдел маркетинга или группа разработчиков продукта должны иметь возможность сообщить вам, кто является предполагаемым Пользователем продукта.
(Если они не могут этого сделать, значит, у продукта большие проблемы.
) Попросите их предоставить вам полное описание Пользователя.
Спросите их, можно ли сделать их описание менее строгим (требующим меньше навыков и т. д.) и, таким образом, применимым для более широкой аудитории.
Спросите их, насколько они уверены в своих предполагаемых пользователях.
Спросите их, создали ли они «Персонаж» (см.
ниже) для разработки продукта.
Если да, попросите у них описание этой Персоны.
Мы будем использовать эту информацию для анализа вашего Пользователя в четырех измерениях.
Затем мы превратим идеального пользователя в почти реального человека, которого вы сможете использовать для разработки и написания вашего пользовательского документа.
Время: по моим оценкам, если каналы связи между вами и командами маркетинга и разработки эффективны, вы сможете выполнить эту серию шагов за несколько часов, распределенных на несколько дней.
Это описание вашего пользователя/читателя является важным элементом в структурировании и написании вашего пользовательского документа.
ЧЕТЫРЕ ИЗМЕРЕНИЯ ВАШЕГО ПОЛЬЗОВАТЕЛЯ (читателя вашего документа) Четыре измерения определяют вашего пользователя/читателя.
Эти размеры: Навыки Какими навыками, по вашему мнению, должен обладать ваш читатель, чтобы понимать ваш пользовательский документ? (Это те навыки, которыми, по вашему мнению, они обладают, когда они НАЧИНАЮТ читать ваш Пользовательский документ. а не те, которым вы их научите в Пользовательском документе.
) Классический пример неудачи: компания, которая преподавала программирование, не указала, что ее студенты должны знать, как использовать конкретный текстовый процессор.
В результате учащиеся потратили 80% учебного времени на то, чтобы научиться пользоваться текстовым процессором, а не на то, чтобы научиться писать программы.
Класс оказался провальным.
Перечислите навыки, которыми, по вашему мнению, должен обладать ваш Читатель.
Отношение Отношение вашего Читателя почти всегда представляет собой комбинацию гнева (нетерпения из-за необходимости читать это вместо использования продукта) и страха (что-то работает не так, как ожидает ваш Читатель).
Пишите с состраданием к своему читателю.
Существуют ли другие взгляды, которые могут повлиять на то, как ваш Reader использует продукт и вашу документацию? Знание Какую информацию вы ожидаете от читателя, когда он прочитает ваш Пользовательский документ? Есть ли что-то, что, по вашему мнению, ваши читатели поймут или что им придется выяснить самостоятельно? Если такие предметы есть, то вам следует сообщить своему Читателю, где взять необходимую справочную информацию.
Опыт Навыки плюс практика дают опыт. Ожидается ли, что ваши читатели получат какой-либо опыт, чтобы они могли понять, как использовать продукт или понять, что вы пишете? ОСТЕРЕГАЙТЕСЬ опыта ваших читателей, который может негативно повлиять на то, как они используют ваш продукт. Одним из примеров является продукт, который радикально меняет способ действий Пользователя в настоящее время.
Выделите немного места в своем пользовательском документе для преодоления этих проблемных ситуаций.
ПИШИТЕ ДЛЯ ВАШЕГО ЧИТАТЕЛЯ Эти четыре измерения составляют слово «САКЕ».
Это напоминает нам писать ради наших читателей.
Вы используете эти четыре измерения при создании тем для своего пользовательского документа, а также при просмотре написанного вами материала.
Это темы для других статей из серии «Новый технический писатель».
Обязательно сообщите своему читателю обо всех предположениях SAKE, которые вы делаете в отношении них.
Таким образом, если вы предполагаете, что у них есть специальные навыки, например, «сварка стали», сообщите им о своем предположении в начале Пользовательского документа.
Если возможно, расскажите им, где они могут получить фоновые предметы SAKE, которые им могут понадобиться.
Например, если вы предполагаете, что ваш читатель умеет идентифицировать определенную птицу, скажите ему, что ему нужно научиться идентифицировать эту птицу (возможно, со ссылкой или ссылкой на орган по орнитологии).
Вы хотите избежать ситуаций, подобных той, что приведена в приведенном выше примере: неустановленное требование знания конкретного текстового процессора, которое испортило урок программирования.
Разумно ли предположение, что все знают, как пользоваться этим эзотерическим текстовым процессором? Разработчикам курса следовало проконсультироваться в своем отделе продаж, поскольку они продавали курс студентам, которые не могли знать об этом эзотерическом текстовом процессоре.
Вы действительно должны четко указать (в начале вашего Пользовательского документа) любые необычные предположения, которые вы делаете о своем Reader. ВАШ ЧИТАТЕЛЬ КАК РЕАЛЬНЫЙ ЧЕЛОВЕК Из измерений SAKE и из описаний типичного Пользователя продукта, которые вы получили от команд маркетинга или разработчиков, вы создадите максимально реального человека, который будет представлять вашего типичного Пользователя.
Такое представление в индустрии разработки продуктов называется Персоной.
Persona также является вашим средством чтения пользовательских документов.
Если команды по маркетингу и разработке используют Персону и предоставили вам описание, используйте их Персону.
Возможно, вам придется добавить к нему какое-то описание.
Если вам нужно создать Персону, выполните следующие действия (обзор): 1. Представьте себе обычного пользователя вашего продукта.
2. Сосредоточьтесь на этом пользователе.
Опишите пользователя.
Подумайте о его/ее происхождении, образовании, семье, хобби, интересах.
Цель состоит в том, чтобы сделать вашего обычного пользователя максимально осязаемым.
3. Возможно, дайте Пользователю имя и даже потратите минуту или две на поиск фотографии этого Персоны.
4. Оцените сами, является ли этот Персон хорошим представлением Пользователя.
Внесите изменения по мере необходимости.
Подумайте, как Персона получила ваш товар (например, купили ли он его, шел ли он в комплекте с каким-то другим товаром, был ли это подарок и т. д.).
Подумайте, что они, скорее всего, захотят сделать с вашим продуктом.
Позже мы будем использовать Персону, чтобы определить темы Пользовательского документа и помочь вам написать сам текст. ПРОВЕРЯТЬ После того как вы создали элементы SAKE и Persona, запишите их и позвольте членам команды по продукту и маркетингу проверить их точность.
«Точность» означает, «насколько близко ваша Персона совпадает с их (продуктовой и маркетинговой командой) представлением о Пользователе продукта».
Обсудите эти моменты и при необходимости внесите изменения.
ИСПОЛЬЗОВАНИЕ РИДЕРА К сожалению, большинство курсов и книг по техническому письму останавливаются на этом в своих инструкциях о том, как «знать своего читателя».
Эти курсы и книги предполагают, что вы просто будете помнить о своем читателе, когда будете писать.
Но с описанием вашего Ридера можно и нужно делать гораздо больше.
Persona поможет вам структурировать информацию в общем документе пользователя; это также поможет вам написать каждую из тем.
Размеры SAKE помогут вам при доработке текста.
Здесь размеры SAKE будут помочь вам избежать использования языка, который ваш Читатель может не понять, и поможет вам избежать скачков в написании, которые ваш читатель не сможет сделать.
В других статьях серии «Новый технический писатель» будет описано, как использовать измерения Persona и SAKE для разработки и написания пользовательского документа.
См.
раздел «Ресурсы» или «Информация об авторе» этой статьи, чтобы найти ссылки на соответствующие статьи.
-
Преимущества Ветроэнергетики
19 Oct, 24 -
Лука, Архепископ, Св.
19 Oct, 24 -
Импровизационная Комедия Для Ораторов
19 Oct, 24 -
Старинная Притча О Том, Чего Хочет Женщина
19 Oct, 24
