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

    View Slide

  2. Zodiac Interactive
    • ПО для индустрии кабельного телевидения
    • Полный software stack для ТВ-приставок (ARM/MIPS, Linux, embedded C++)
    • Серверные и инфраструктурные решения для операторов ТВ
    • Продуктовые решения, заказная разработка на их основе
    • R&D-активности

    View Slide

  3. Виды бизнес-процессов
    • Per-project
    • Непрерывная производственная деятельность

    View Slide

  4. Per-project
    • Любой проект делается «с нуля»: каждый раз как в первый раз
    • Простая декомпозиция, простые постановки задач исполнителям
    • Процессы часто линейны: вдвое больше разработчиков — вдвое
    меньше время на разработку

    View Slide

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

    View Slide

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

    View Slide

  7. Непрерывная производственная
    деятельность
    • Документация глубоко интегрирована во все процессы:
    регламент, контроль, приемка...

    View Slide

  8. Непрерывная производственная
    деятельность
    • Документационные задачи
    • слабо отчуждаемы
    • не имеют четкого выражения в деньгах (редко продаются
    заказчику)
    • могут иметь неочевидные постановки

    View Slide

  9. Сложность разработки
    • Многочисленные зависимости
    • Legacy code base
    • Технологические риски
    • Новые, доселе неизвестные предметные области (каждый день!)

    View Slide

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

    View Slide

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

    View Slide

  12. Пространство принятия решений
    • Требования
    • Полнота
    • Структурированность и удобство доступа
    • Метрики (решение А на 25% лучше решения Б)

    View Slide

  13. Пространство принятия решений
    • Критерии качества
    • Правильность принятого решения (в т.ч. и в терминах денег)
    • Скорость принятия решения

    View Slide

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

    View Slide

  15. Пространство принятия решений
    • Хорошо работающее ППР — основа успешности бизнеса
    • Ошибки в принятии решений приводят к убыточным проектам,
    неверной стратегии развития и гибели компании
    • ППР — это то, во что компания готова вкладываться

    View Slide

  16. Knowledge management
    Управление знаниями — набор техник по наполнению пространства
    принятия решений и обеспечению доступа к нему

    View Slide

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

    View Slide

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

    View Slide

  19. Knowledge management
    • Создание (или управление) технической документацией — это
    KM на каком-то уровне иерархии задач в компании
    • Относитесь к документации как к способу формировать
    пространство принятия решений на вашем уровне

    View Slide

  20. Knowledge management
    • Многие компании не выделяют отдельных людей на
    высокоуровневый KM (но очень хотели бы их иметь)
    • Техписатель может вырасти в специалиста по KM на более
    высоких уровнях

    View Slide

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

    View Slide