Upgrade to Pro — share decks privately, control downloads, hide ads and more …

С той стороны зеркального стекла: взгляд на док...

С той стороны зеркального стекла: взгляд на документацию с точки зрения бизнеса (Максим Строев)

http://docfactor.ru
http://documentat.io

DocFactor'17, конференция о технической документации. 26 ноября 2017, Новосибирск, НГУ.

С той стороны зеркального стекла: взгляд на документацию с точки зрения бизнеса. Максим Строев, HDsoft/Zodiac Interactive, R&D Director

Видео: https://www.youtube.com/watch?v=Xvl0vE8ilq4

Давайте ненадолго отвлечемся от изучения технической документации с точки зрения ее создателей и посмотрим на нее глазами руководителей и владельцев IT-компаний.

В этом докладе мы поговорим о следующем:

- Приносят ли технические писатели деньги своим компаниям?
- В какой момент документация становится конкурентным преимуществом компании?
- Могут ли хорошо настроенные процессы документирования быть гарантией безопасности бизнеса?
- Почему при общении с бизнесом нужно использовать термин «управление знаниями», а не «техническая документация/техническая коммуникация»?

More Decks by DocFactor: конференция о технической документации

Other Decks in Education

Transcript

  1. С той стороны зеркального стекла Взгляд на техническую документацию с

    точки зрения бизнеса Максим Строев HDsoft/Zodiac Interactive, R&D Director
  2. Zodiac Interactive • ПО для индустрии кабельного телевидения • Полный

    software stack для ТВ-приставок (ARM/MIPS, Linux, embedded C++) • Серверные и инфраструктурные решения для операторов ТВ • Продуктовые решения, заказная разработка на их основе • R&D-активности
  3. Per-project • Любой проект делается «с нуля»: каждый раз как

    в первый раз • Простая декомпозиция, простые постановки задач исполнителям • Процессы часто линейны: вдвое больше разработчиков — вдвое меньше время на разработку
  4. Per-project • Документационные задачи очевидны и легко формализуемы • И

    часто вообще отчуждаемы • Документация — один из проектных артефактов, который продается заказчику или включается в итоговую цену продукта
  5. Непрерывная производственная деятельность • Сложный монолитный бизнес-процесс, в рамках которого

    реализуются разнотипные проекты, R&D и операционная деятельность • Декомпозиция на задачи сложна и неочевидна • Процессы нелинейны: малое изменение входных параметров может многократно изменить стоимость/сроки/эффективность
  6. Непрерывная производственная деятельность • Документационные задачи • слабо отчуждаемы •

    не имеют четкого выражения в деньгах (редко продаются заказчику) • могут иметь неочевидные постановки
  7. Сложность разработки • Многочисленные зависимости • Legacy code base •

    Технологические риски • Новые, доселе неизвестные предметные области (каждый день!)
  8. Сложность разработки • Нелинейность (R&D-активности плохо параллелятся) • Цена ошибки

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

    между ними, позволяющий принимать решения (организацонные, технические и т.д.)
  10. Пространство принятия решений • Требования • Полнота • Структурированность и

    удобство доступа • Метрики (решение А на 25% лучше решения Б)
  11. Пространство принятия решений • Применимо на всех уровнях • Бизнес

    и компания • Развитие продукта • Работа отдела/команды • Конкретные архитектурные решения в конкретном программном компоненте • Реализация конкретного алгоритма
  12. Пространство принятия решений • Хорошо работающее ППР — основа успешности

    бизнеса • Ошибки в принятии решений приводят к убыточным проектам, неверной стратегии развития и гибели компании • ППР — это то, во что компания готова вкладываться
  13. Knowledge management • Извлечение фактов • Их анализ, обработка, упорядочивание

    и структурирование • Отслеживание актуальности • Обеспечение удобного доступа и поиска
  14. Knowledge management • Извлечение фактов • Их анализ, обработка, упорядочивание

    и структурирование • Отслеживание актуальности • Обеспечение удобного доступа и поиска Техписатели, узнаете себя?
  15. Knowledge management • Создание (или управление) технической документацией — это

    KM на каком-то уровне иерархии задач в компании • Относитесь к документации как к способу формировать пространство принятия решений на вашем уровне
  16. Knowledge management • Многие компании не выделяют отдельных людей на

    высокоуровневый KM (но очень хотели бы их иметь) • Техписатель может вырасти в специалиста по KM на более высоких уровнях
  17. Что делать? • Относитесь к своей документационной работе как к

    knowledge management • Если интересно — поднимайтесь на более высокие уровни KM • Покажите руководству, что занимаясь этой деятельностью, вы сможете приносить/экономить деньги компании