О чём курс
Создание инструкций — процесс нелегкий. Как сделать их информативными и для опытных пользователей, и для новичков? Как оформить в соответствии со всеми требованиями? Какие инструменты облегчают процесс создания инструкции? В чем принципиальное отличие тире от дефиса, и почему важно уметь правильно их расставлять? Все эти вопросы рассматриваются в данном курсе, в частности, обсуждаются: структура документа, правила изложения и форматирования текста, а также критерии качества документации. Слушателям будет предложено проанализировать множество примеров неудачных формулировок, взятых из разных источников, и исправить их.
Создание технической документации, включая технические задания, спецификации требований и подобные материалы, не является основной работой технического писателя. Однако специалист должен понимать эти документы и уметь извлекать из них необходимую информацию для подготовки пользовательской документации. Поэтому в курсе рассматривается одна из форм описания требований — сценарии использования, которые могут быть преобразованы в подробные пошаговые инструкции для пользователей.
Цели
Основная задача курса — снабдить слушателя профессиональными знаниями и навыками, необходимыми для создания пользовательской документации к программным продуктам.
После завершения обучения слушатели смогут:
- 1. определять требования к документации и руководствоваться ими в работе;
- 2. улучшить навык корректного изложения информации;
- 3. применять правила организации и оформления документации;
- 4. находить и исправлять типовые ошибки в технической документации;
- 5. использовать продвинутые средства форматирования текста на примере MS Word.
Предварительная подготовка
Для качественного освоения программы требуется:
1. общее представление о разработке ПО;
2. опыт использования текстовых процессоров и других программных продуктов для работы с текстом.
Для кого
Системный аналитик
Технический писатель
Улучшаемые навыки
Техническое письмо
Структурирование документации
Работа с требованиями
Локализация текстов
Обеспечение качества документации
Техническая документация
User guides
MS Word
Сценарии использования
Инструменты
MS Word
Расписание курсов
Программа курса
Задачи технического писателя
Требования к документации
02
Этапы создания документации и виды работ
Создание документации как часть проекта по разработке ПО
Этапы разработки документации
Задание на разработку документации
03
Виды, типы и структура документов
Разновидности технических документов
Форма и структура документа, типы информации
Сценарии использования
Разработка функциональной части документа
Разработка справочных и описательных частей документа
Структурно-обусловленные разделы
04
Разработка и организация текста
Основные принципы изложения
Разбор примеров некачественных текстов
Оформление документов
Отличия русско- и англоязычной документации
Описания для специфических элементов
Обеспечение качества документации
Инструментарий и ресурсы для технического писателя
Рекомендации по работе с MS Word
Дополнительные онлайн ресурсы и полезные иснтрументы
05
Итого на курс часов: теория – 12 ч (75 %), практика – 4 ч (25 %)
Чему вы научитесь
01
Определять требования к документации и применять их на практике.
02
Формулировать информацию четко и без ошибок.
03
Организовывать документы по международным стандартам.
04
Находить и исправлять типовые ошибки в технических текстах.
05
Использовать продвинутые функции MS Word для автоматизации работы
Курс проводят
Подолина Ольга
Специалист в области системного и бизнес-анализа
О тренере
Работает аналитиком с 2006 года. Специализация: проектирование информационных систем (системы электронного документооборота, электронные архивы, их интеграции с другими информационными системами, включая системы налогового мониторинга, RPA-роботы, ИИ-чат-боты для бизнеса).
До 2006 года-автоматизация бухучета (в качестве программиста). Для лучшего понимания предметной области получила сертификат профессионального бухгалтера.
О проектах:
Проекты по внедрению систем электронного документооборота, электронных архивов(очень много: Министерство здравоохранения, Правительство Москвы, Пенсионный фонд, Норильский Никель,НИИ «Восход», Росатом,Центробанк и пр.), электронных архивов, внедрение RPA -роботов. Роль- бизнес-аналитик, функциональный архитектор, руководитель проектов