Эффективная разработка пользовательской документации
Всем хорошо известна фраза «Если ничего не получается, прочтите, наконец, инструкцию». Но как же написать инструкцию так, чтобы желание ее прочесть возникало еще до начала работы с программным продуктом? Как сделать ее информативной и для опытных пользователей, и для новичков? В курсе рассматривается процесс создания пользовательской докуменнтации к программным продуктам. В частности, обсуждаются: структура документа, правила изложения, правила форматирования текста и критерии качества документации.
16 ак.ч.
Онлайн
REQ-028
Эффективная разработка пользовательской документации
Записаться на курс
Длительность
16 ак.ч.
Локация
Онлайн
Код
REQ-028
Расписание и цены
24 500 руб.
* Для физических лиц действует скидка 10% Закажите корпоративное обучение с учетом ваших потребностей
Эффективная разработка пользовательской документации
Записаться на курс
Длительность
16 ак.ч.
Локация
Онлайн
Код
REQ-028
Расписание и цены
24 500 руб.
* Для физических лиц действует скидка 10% Закажите корпоративное обучение с учетом ваших потребностей

Описание

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

Много внимания в курсе уделяется вопросам корректного формулирования и оформления текста.

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

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

Цели

Основная задача курса – снабдить слушателя профессиональными знаниями и навыками, необходимыми для создания пользовательской документации к программным продуктам.

После завершения обучения слушатели смогут:

  • определять требования к документации и руководствоваться ими в работе;
  • улучшить навык корректного изложения информации;
  • применять правила организации и оформления документации;
  • находить и исправлять типовые ошибки в технической документации;
  • использовать продвинутые средства форматирования текста на примере MS Word.

Целевая аудитория

Программа ориентирована на технических писателей, в том числе начинающих.

Предварительная подготовка

Для качественного освоения программы требуется:
  • общее представление о разработке ПО; 
  • опыт использования текстовых процессоров и других программных продуктов для работы с текстом.

Разбираемые темы

  • 1. Качество документации

    • Задачи технического писателя (теория – 60 мин, практика – 20 мин);
    • Требования к документации (теория – 50 мин, практика 20 мин).
  • 2. Этапы создания документации и виды работ

    • Создание документации как часть проекта по разработке ПО (теория – 30 мин, практика – 20 мин);
    • Этапы разработки документации (теория – 30 мин);
    • Задание на разработку документации (теория – 15 мин).
  • 3. Виды, типы и структура документов

    • Разновидности технических документов (теория – 30 мин);
    • Форма и структура документа, типы информации (теория – 40 мин);
    • Сценарии использования (теория – 70 мин, практика – 40 мин);
    • Разработка функциональной части документа (теория – 15 мин);
    • Разработка справочных и описательных частей документа (теория – 15 мин);
    • Структурно-обусловленные разделы (теория – 15 мин).
  • 4. Разработка и организация текста

    • Основные принципы изложения (теория – 120 мин, практика – 30 мин);
    • Разбор примеров некачественных текстов (практика – 40 мин);
    • Оформление документов (теория – 40 мин);
    • Отличия русско- и англоязычной документации (теория – 40 мин);
    • Описания для специфических элементов (теория – 40 мин);
    • Обеспечение качества документации (теория – 40 мин, практика – 30 мин).
  • 5. Инструментарий и ресурсы для технического писателя

    • Рекомендации по работе с MS Word (теория – 40 мин, практика – 40 мин);
    • Дополнительные онлайн ресурсы и полезные инструменты (теория – 30 мин).
  • Развернуть программу
Раcписание курсов
Вид:
Регистрируйтесь на следующий курс
Предварительная регистрация гарантирует участие в обучении. Мы обязательно оповестим вас, когда курс будет запланирован
+
Отзывы (4)
Общее впечатление – очень положительное, все доходчиво и понятно. Наиболее полезны практические задания с разбором их выполнения. Написание СИС, выбор оптимальных вариантов.
Участник тренинга
Получил исчерпывающую информацию о профессии технического писателя. Тренинг помог систематизировать уже имеющиеся знания и навыки. Новой для меня была информация о тестировании тех. документации, что является весьма полезным в нашей работе, данную функцию (опцию) я хочу предложить использовать руководству.
Участник тренинга
Понравилось, что нам рассказали о документации и общих практиках, поделились пониманием принципов написания пользовательской документации. Весь курс очень хорошо структурирован, материалы хорошие, много практических советов и обсуждений. Никакой "воды" - всё только по делу.
Участник тренинга
Хороший курс. Больше всего мне понравилось, как были представлены примеры, объяснения, часть сценариев использования (use case), а также занятие по лайфхакам и фишкам в MS Word, ясность, четкость и динамичность материала. Полезным было практически все.
Участник тренинга
Показать все отзывы
Рекомендуемые дополнительные материалы, источники
Философт (статьи и форум). 
Языковой портал Microsoft (терминология).
Word MVP Site (статьи по Word).
Technical Writing Tips (общие советы).
Ваши преимущества
Экспертность
Тренеры-эксперты из реальных проектов крупнейших компаний, лидеров в своей отрасли
Живое обучение
“Живая” коммуникация с тренером даже в онлайн-формате
Практика
Максимально наполненные практикой занятия, работа в группах, выполнение домашних заданий
Пользователь только что записался на курс ""
Спасибо!
Форма отправлена успешно.