Летопись проекта: зачем нужна инфраструктурная документация

[BA_TW]

Крайне важный вопрос - как поддерживаете документацию в актуальном состоянии? Кто ее владелец и как он отслеживает изменения, которые нужно отразить в документации?

[aleksabud]

Да, актуальность это важный фактор. Так как проектов у нас на поддержке много, то просто так постоянно обновлять их все задача слишком трудозатратная. У нас это частично решено тем, что создание документации встроено в жизненный цикл поддержки клиентских инфраструктур. Например, когда новый клиент приходит на поддержку, проводится аудит инфраструктуры и одним из этапов аудита является создание документации. Или если в инфраструктуру вносятся изменения - например, принимается на поддержку новый сервер, то в рамках принятия вносятся изменения и в документацию.
В общем каждый раз есть какой-то фактор, который запускает инициацию обновления документации проекта.

На самом деле в ближайшее время у нас выйдет статья про жизненный цикл документации, где об этом будет подробнее рассказано.

[BA_TW]

Спасибо, буду ждать новой статьи.

Для нас актуализация документации - больной вопрос. Вот думаю над определением триггеров для обновления. Бывают очевидные как в Ваших примерах, а бывают нет. Понимаю, что надо встраивать в жизненный цикл, кое-что уже встроено, но над многим предстоит поработать.