x
 
Галина
15 сентября 2019
Советы почтой каждую неделю
Пожалуйста, получите наше письмо, чтобы подтвердить свой адрес:
Вы подписаны на «Советы за неделю»:

Вопрос Людмиле Сарычевой. Как структурировать инструкцию пользователя? Описать каждую вкладку программы, функционал каждой вкладки? Или описать конкретные сценарии работы пользователей?


Галина!

Всё зави­сит от того, в какой момент поль­зо­ва­тель возь­мётся за инструк­цию. Если это пер­вое зна­ком­ство с про­грам­мой, и он хочет знать, что она умеет — опи­сы­вать функ­ции. Если раз­би­ра­ется по ходу своих задач — сценарии.

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

Чтобы опла­тить покупку...

Если хотите вер­нуть деньги на дру­гую карту...

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

Реко­мен­дую почи­тать ещё советы об инструкциях:

P. S. Это был воскресный совет о хорошем тексте. Присылайте вопросы

Текст и редактура — дисциплина Школы редакторов. Набор закрыт. Оставьте почту, и мы напишем вам, когда откроется следующий набор.
 

Поделиться
Отправить

Комментарии

Юлия Бородулина
13 ноября 2019

«меня настораживает, что вы хотите писать инструкцию для программы»

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


Цель рубрики — обсуждение вопросов дизайна всех видов, текста в дизайне и взаимоотношений дизайнеров с клиентами.

Мы публикуем комментарии, которые добавляют к уже сказанному новые мысли и хорошие примеры. Мы ожидаем, что такие комментарии составят около 20% от общего числа.

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

Вот такой веб 2.0.

Где лучше искать проекты? Как выбрать правильный вектор развития и сделать подобие плана обучения? 2 Клиент просит написать 1-2 тестовых текста 2 Очень хочется вести блог или телеграм-канал о редактуре 1




Недавно всплыло

Сайты для слабовидящих 2 2 Как найти себе замену 1 В бюро есть таймтрекинг для сотрудников? 5