Сколько раз вы в последний месяц искали в голове команду, которую выполняли вчера? Или пытались восстановить порядок действий после инцидента, но понимание туманнеет при каждом новом шаге? Если это про вас — вы уже проигрываете время и рискуете допустить ошибки, которые легко предотвратить.
Веду личный wiki не потому, что это модно
Я делаю это потому, что мозг — не надёжное хранилище фактов. Кривая забывания Эббингауза — не просто слова: через неделю вы теряете большую часть деталей. Представьте, что вы три дня спорили с сервисом и нашли костыль, который работает. Не записали — через месяц будете решать ту же проблему заново. Записали — тратите три минуты на поиск и идёте дальше.
Бывают те инциденты, которые в одночасье ломают процесс доставки. Я однажды в спешке применил правку в prod и не отметил, почему это сделано. Через две недели при откате я не понял, зачем та строка была добавлена, и восстановил старое поведение — с последствиями. Если бы была заметка «почему» и «как тестировали» — откат прошёл бы осмысленно. Это просто: пара строк, контекст и дата — и через месяц вы спасены.
Личный wiki экономит не только время на восстановление, но и на принятие решений
Утро инженера: нужно срочно сократить задержку, менять конфигурацию или переключать реплики? Открыл заметку — видишь прошлые измерения, аргументы за и против, результат тестов. Без этого вы рискуете дублировать чужую работу или действовать вслепую. Выбрать правильное действие можно за минуты, а не за часы размышлений.
Какие заметки реально помогают — короткий список:
- Runbooks и checklists: что делать при падении сервиса, шаги и команды.
- Командные сниппеты: рабочие команды SSH, kubectl, systemctl с параметрами.
- Инцидент-лог и постмортем: что произошло и почему это случилось.
- Рецепты деплоя и отката: последовательность, ожидаемые симптомы.
- Контакты и доступы: кто отвечал за систему и где искать ключи (без открытых паролей).
- Каждый пункт — не толстая инструкция, а минимальный набор информации, который возвращает контекст.
Не нужно ничего сложного: markdown-файлы в git, простая заметочная программа или локальное wiki. Важнее не инструмент, а привычка: писать сразу, кратко и с датой. Мои заметки обычно состоят из заголовка, трёх шагов и двух строк про причину. Это занимает меньше минуты, зато спасает часы в будущем.
Есть ещё эффект «мысленного капитала»
Когда вы видите историю решений — вы учитесь на собственных ошибках быстрее. Записи дают объективный рефлекс: что сработало, что нет, какие гипотезы были отвергнуты. В команде это очевидно, но в одиночке это деловое преимущество: вы становитесь эффективнее без лишнего стресса.
Предупреждение: если не структурировать заметки, они превратятся в хаос. Сделайте простую систему меток, именования файлов и поиска. Один каталог — один домен: сеть, базы, деплой. И правило: после любой экстренной операции — добавить пару строк, почему и что ожидалось. Это простое правило убирает 80% повторов.
Вопрос напоследок: хотите продолжать тратить время на повторные расследования и рисковать продактом, или хотите иметь понятный журнал ваших действий? Личное wiki — это не филантропия, это страховка вашего времени и вашей спокойной головы. Начать можно с одной заметки. Сделайте её сейчас, и через месяц вы скажете себе спасибо.