Есть в аналитике одна вещь, которую все знают, но почти никто не делает. Это документация.📄

Ну серьёзно, кто любит её писать? Вот сидишь ты, сделал задачу, всё работает, данные считаются, графики рисуются. И тут тебе говорят: "А задокументируй, пожалуйста". И ты такой: "Зачем? Я же и так всё помню. Я же умный". Спойлер: через месяц ты не помнишь ничего. Вообще. Даже как задачу назвал.🫠

И начинается классика. Приходишь к своему же коду или отчёту и смотришь на него как на чужой. "Что это за поле? Почему тут фильтр по дате? А что значит эта метрика?" И самое страшное - ты сам это писал. Ты сам придумал эту логику. Но сейчас ты сидишь и гадаешь, как археолог над древними письменами.

А если задачу передали коллеге? Всё, приехали. Он открывает твоё творчество, смотрит и думает: "Это что, шифр? 😵‍💫 Мне теперь что, звонить ему в отпуск?" И звонит. И ты объясняешь по телефону то, что можно было написать в двух строчках. Красота. Я сам долго думал, что документация - это для бюрократов. Ну реально, зачем тратить время, если можно делать задачи? А потом я понял простую вещь: документация - это не для начальника. И не для проверяющих. Она для тебя. Для твоей команды. Для того, чтобы через полгода ты не сидел с квадратной головой и не пытался вспомнить, что ты имел в виду.

Запомни‼️ Хорошая документация экономит часы. Ты один раз написал - и все читают. Не надо объяснять по десять раз одно и то же. Не надо переспрашивать. Не надо бояться, что кто-то сломает твою логику, потому что он не понял, как она работает.

И знаете, что ещё?🙂‍↕️ Документация помогает думать. Когда ты описываешь логику текстом, ты начинаешь видеть дыры. Оказывается, вот тут не учтён кейс. А вот тут метрика считается не так, как ты думал. Письмо - это лучший способ найти свои же ошибки. Короче, документация - это не скучно. Это уважение к себе и к тем, кто работает рядом. Один раз потратил время - сэкономил десять раз потом. Так что если вы сейчас думаете "да ладно, потом напишу" - напишите сейчас. Потом не будет. Потом будет только боль и звонки в отпуск. А вы пишете документацию или из тех, кто "и так всё помнит"? 👇