Документация — это набор технических спецификаций, архитектурных документов, инструкций по установке и настройке, описаний процессов, пользовательских руководств и других материалов, необходимых для успешной реализации ИТ-проекта.
Документация позволяет:
Концепция проекта (проектная документация). Соотносит желания заказчика с его возможностями: описывает цели и требования проекта, варианты технических предложений, связанные с ними затраты, возможности и риски. Помогает принимать решения.
Рабочая документация. Описывает замысел проекта, все аспекты его реализации и конечный результат. Создается до начала выполнения работ. Не инструктирует, как настраивать системы, а задает уровень требований к тому, что и как должно быть сделано. Позволяет заказчику получать ожидаемый и верифицируемый итог, не зависящий от конкретного исполнителя.
Исполнительная документация. Это атрибут качественно настроенной системы, который полностью отражает все её аспекты и помогает передать её в эксплуатацию. В идеале аналогична рабочей документации, но может содержать протокол расхождений, если некоторые этапы были выполнены с отклонением от первоначального замысла. Создается по окончанию проекта и должна включать все необходимые данные для дальнейшего обслуживания и развития системы.
Качественные проекты невозможны без документации, особенно — инфраструктурные, которые связаны с созданием, расширением или модернизацией ИТ-инфраструктуры предприятия. Хороший продукт опирается на проработку и сопоставление всех деталей, а зафиксированные на бумаге технические решения можно показывать внешним экспертам, обсуждать, критиковать и дорабатывать ещё до внедрения.
Поэтому, по нашему мнению, проект без документов — это проект «с колес», который выполняется в спешке, на ходу и без четкого планирования. Его результат непредсказуем, и мы не рекомендуем полагаться на такой подход.