(8) Для чего нужны Help Authoring Tools на примере MadCap Flare

(8) Для чего нужны Help Authoring Tools на примере MadCap Flare

http://documentat.io/sdo

http://documentat.io/sdo/courses/open-course

Открытый онлайн-курс о технической документации в IT-проектах.

Чат для обсуждений: https://t.me/TechDocIT

Лекция 8. Для чего нужны Help Authoring Tools на примере MadCap Flare (Ольга Морланг, Petrosoft, руководитель группы технических писателей)

Видео: https://youtu.be/6fAQ1HC5fqI

5c1a5fe91c52688c80fae07dd3632a02?s=128

documentat.io

May 29, 2020
Tweet

Transcript

  1. 2.

    О ЧЁМ БУДЕМ ГОВОРИТЬ  • О том, для чего нужны

    инструменты документирования  • Обзор преимуществ на примере MadCap Flare  • Особенности использования  • Основные этапы процесса документирования
  2. 3.

    О СЕБЕ  • Технический писатель - разработка пользовательской документации для

    зарубежных программных продуктов  • В сфере IT – 10 лет, в документировании – 5 лет  • Руководитель отдела документирования программных продуктов (Technical Writers Team Lead) Petrosoft LLC petrosoftinc.com  Ольга Морланг   olkamorlang   omorlang@hotmail.com   olga.morlang Май, 2020
  3. 4.

      • Автоматизация деятельности сетей АЗС и предприятий розничной торговли

    в сфере общественного питания   • Разработка программных и аппаратных решений   • Продукты компании интегрированы в облачную экосистему   • Веб-портал корпоративного университета Petrosoft University Portal разработан на базе MadCap Flare: help.petrosoftinc.com   • Petrosoft University Portal включён в базу уникальных решений на базе MadCap Flare Customer Showcase: https://www.madcapsoftware.com/customers/customer-showcase/ О КОМПАНИИ Petrosoft LLC основана в 2002 году в США
  4. 5.

    ДЛЯ ЧЕГО НУЖНЫ Пользовательская документация Программный продукт Инструменты документирования нужны

    для разработки и сопровождения удобных в использовании справочных систем по программным продуктам.
  5. 6.

      • Формат (онлайн + офлайн) ОСНОВНЫЕ ПРЕИМУЩЕСТВА Пользовательская документация

    Программный продукт   • Контекстная ориентированность (context-sensitive help)   • User Experience (UX) (управление стилями, интерактивность, адаптивность, анализ поведения пользователя)   • Single Source (единый источник)   • Source Control + CI (источник + билд)
  6. 7.

    КАК РАБОТАЕТ   Работа с источником +   Настройка параметров

    сборки   • Условия (Conditional Tags)   • Формат (PDF, HTML и др.)   • Стили   • Элементы навигации   • ...   Руководство пользователя (PDF)   Руководство администратора (PDF)   Веб портал (онлайн-справка) Справочная система для мобильных устройств
  7. 8.

      • Формат: онлайн, офлайн, мультиформат КАК ИСПОЛЬЗОВАТЬ: ФОРМАТ • Настройка

    стилей. • Поддержка оптимальной структуры. • Автоматизация сборки.
  8. 9.

      • Контекстная ориентированность (context sensitive help) КАК ИСПОЛЬЗОВАТЬ: КОНТЕКСТНАЯ

    ОРИЕНТИРОВАННОСТЬ • Выстраивание процесса. • Поддержка контекстных ссылок в актуальном состоянии.
  9. 10.

      • Single Source (принцип единого источника) КАК ИСПОЛЬЗОВАТЬ: ЕДИНЫЙ

    ИСТОЧНИК • Создание инфраструктуры: переменные, сниппеты, условия. • Поддержка инфраструктуры, регулярный контроль. Image Source: https://www.madcapsoftware.com/blog/single-sourcing-explained-the-power-of-madcap-flare/ Jorgeo Catolico: “Single Sourcing Explained: The Power of MadCap Flare”
  10. 11.

      • User Experience: управление стилями, интерактивность, адаптивность, анализ поведения

    пользователя КАК ИСПОЛЬЗОВАТЬ: USER EXPERIENCE Для индивидуальных решений потребуются: • Дополнительные компетенции: HTML + CSS, JavaScript. • Более глубокое изучение инструмента документирования.   • Единые стили для различных элементов документа   • Адаптивный дизайн для веб и мобильных устройств   • Поиск, фильтрация результатов поиска   • Перекрёстные ссылки, выпадающие списки, кнопки, видеоблоки   • Различные элементы навигации: меню, «хлебные крошки», кнопки перехода между разделами   • Получение обратной связи от пользователей, анализ пользовательского поведения   • Анализ пользовательского поведения
  11. 12.

      • Source Control + Continuous Integration: совместная работа с

    одним источником данных + автоматический деплой документации КАК ИСПОЛЬЗОВАТЬ: SOURCE CONTROL + CI • Базовые принципы работы с SVN. • Организация процесса совместной работы: - команда тех.писателей - команда тех.писателей + команда разработки ПО
  12. 13.

    Source Updates • Создание и/или обновление источника локально на рабочем месте

    технического писателя Commit/Push Source Updates • Отправка изменений источника в общий репозиторий через систему контроля версий Build Creation • Создание комплекта документации из источника с последними изменениями Commit/Push Help Build • Отправка обновлённого комплекта документации в репозиторий через систему контроля версий Build Deploy • Автоматический деплой обновлённого билда на рабочее окружение ПРОЦЕСС РАЗРАБОТКИ ДОКУМЕНТАЦИИ