Разработка технической документации. Практика
Курс посвящен процессу документирования в IT проектах. В нем представлены основные принципы создания технического документа. Рассмотрены типичные ошибки разработчиков технической документации. Описаны особенности профессии технического писателя, и предложены рекомендации по настройке процесса документирования
Целевая аудитория
Технические писатели
Сотрудники технической поддержки
Аналитики
Руководители и менеджеры проектов
Кроме того, к основной целевой аудитории данного курса также относятся квалифицированные специалисты в области информационных технологий, включая разработчиков, желающих улучшить свои знания и навыки в области написания технической документации и понять суть процесса документирования
Получаемые знания и навыки
По окончании курса слушатели смогут- использовать основную терминологию в документирования
- разбираться в видах и структуре документов
- вести сбор и анализ информации, владеть техниками сбора и методологией
- выявлять пробелы в технической документации
- создавать качественные и эффективные документа
- использовать ГОСТы при разработке документов
Программа курса
- Особенности написания технической документации
- Этапы документирования
- Работа с задачей на документирование
- Основные принципы написания технической документации
Цель: Продемонстрировать разницу между корректными и некорректными формулировками и оформлением в инструкциях
- Разработка внутреннего руководство по стилю
- Типы программных продуктов
- Предмет документирования
- Способы чтения документации пользователем
- Детальность изложения в технической документации
- ГОСТ 19
- ГОСТ 34
- Структура ТЗ
- Структура Руководства пользователя
- Международные стандарты документирования
- Особенности написания документации на английском языке
Цель: Продемонстрировать слушателю наполненность и смысл ГОСТов для документирования
Цель: Проигрывание реальной задачи технического писателя для демонстрации некорректного выбора сроков на документирование
- Правила вёрстки
- Основные ошибки в вёрстке технической документации
- ПО для вёрстки
- Роль скриншотов в документе
- Правила оформления скриншотов
Цель: Проверить понимание слушателем основных принципов вёрстки
Цель: Проверить понимания слушателями правил оформления скриншотов
- ПО для планирования рабочего времени
- ПО для написания документации
- ПО для создания и оформления скриншотов
- ПО для создания иллюстраций и схематических изображений
- Создание обучающих видеороликов
- ПО для создания обучающих видеороликов
Цель: Проверить понимание пройденных на курсе тем
