Формализовали плюсы и минусы трёх основных подходов к документированию на проектах.
Мы тут проводим митап от программного комитета KnowledgeConf. В первой половине записали плюсы и минусы разных подходов к документации и тому, как сохранять знания о проекте.
Часть 1. Документация в головах
+ Передавать из уст в уста — это быстро.
+ Информация максимально актуальная
+ Быстрая обратная связь
+ Выкатили новую фичу — сразу есть документация
+ Не пишем доку, экономим деньги бизнеса
+ Развиваем soft skills
+ Люди эмоционально вовлечены
+ Много лайфхаков и багофич, которые не запишешь в документацию
+ Высокая информационная неуязвимость. Никто не сольёт доку, потому что её нет.
+ Высокий уровень доверия, потому что все решения хранятся в головах.
- Не фиксируем договоренности
- Всё в голове не удержишь
- Непосильный труд — донести мысль одинаково для всех
- Не отслеживается версионность
- Неравномерность знаний
- Больше времени занимает онбординг
- Онбординг отвлекает знающих экспертов
- Знания уходят с ключевыми сотрудниками
- Информация искажается при передаче
- Утечки времени на получение знаний на каждом этапе разработки
- Ограничение времени к информации. Ночью не у кого спросить.
- Сложно работать с распределёнными интернациональными комнадами.
- Сложно масштабировать проект.
- Непрозрачность со стороны для аудита, консультирования, помощи
- Культивирует точки экспертизы, которые могут покинуть проект
- Затрудняет повторяемость положительного результата.
Полный конспект тут: https://github.com/NickVolynkin/teamleadconf-19/blob/master/source/km-meetup.md
Мы тут проводим митап от программного комитета KnowledgeConf. В первой половине записали плюсы и минусы разных подходов к документации и тому, как сохранять знания о проекте.
Часть 1. Документация в головах
+ Передавать из уст в уста — это быстро.
+ Информация максимально актуальная
+ Быстрая обратная связь
+ Выкатили новую фичу — сразу есть документация
+ Не пишем доку, экономим деньги бизнеса
+ Развиваем soft skills
+ Люди эмоционально вовлечены
+ Много лайфхаков и багофич, которые не запишешь в документацию
+ Высокая информационная неуязвимость. Никто не сольёт доку, потому что её нет.
+ Высокий уровень доверия, потому что все решения хранятся в головах.
- Не фиксируем договоренности
- Всё в голове не удержишь
- Непосильный труд — донести мысль одинаково для всех
- Не отслеживается версионность
- Неравномерность знаний
- Больше времени занимает онбординг
- Онбординг отвлекает знающих экспертов
- Знания уходят с ключевыми сотрудниками
- Информация искажается при передаче
- Утечки времени на получение знаний на каждом этапе разработки
- Ограничение времени к информации. Ночью не у кого спросить.
- Сложно работать с распределёнными интернациональными комнадами.
- Сложно масштабировать проект.
- Непрозрачность со стороны для аудита, консультирования, помощи
- Культивирует точки экспертизы, которые могут покинуть проект
- Затрудняет повторяемость положительного результата.
Полный конспект тут: https://github.com/NickVolynkin/teamleadconf-19/blob/master/source/km-meetup.md