«У нас всё в Ansible, зачем ещё документация» — фраза, которую слышишь на каждом втором инфраструктурном созвоне. Звучит логично: playbook воспроизводим, идемпотентен, лежит в git — что ещё нужно. На практике этот подход работает ровно до первого вопроса «а почему это сделано именно так», на который отвечает только человек, писавший роль полгода назад и, возможно, уже уволившийся. Разберём, где ломается идея «код — это документация», и что стоит писать рядом со скриптами, чтобы не терять контекст решений.
Подробнее →