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