Документация в распределённой команде
Когда все сидят в одной комнате, нехватку документации компенсируют разговоры. Когда команда разбросана, каждая незаписанная договорённость превращается в переписку на два дня.
Что писать в первую очередь: как запустить проект у себя, как выкатить изменение, что делать при типичных сбоях, кто за что отвечает и почему приняли ключевые решения.
Как писать, чтобы читали: коротко, ответами на реальные вопросы, рядом с кодом, с датой и автором.
Простое правило: объяснили что-то дважды в переписке — на третий раз запишите и дайте ссылку.
И побочный эффект: в распределённой команде человек, который пишет понятные тексты, становится заметным и влиятельным быстрее остальных.
IT Калининград — t.me/kaliningrad_it
IT Калининград
@kaliningrad_it
Документация в распределённой команде
Этот пост опубликован в Telegram-канале IT Калининград. Подписаться можно по ссылке: @kaliningrad_it.