Несколько причин, почему важно документировать код в Agile-проектах:

• Улучшение коммуникации. 1 Документация служит инструментом общения внутри команды и с заинтересованными сторонами. 1 Она проясняет требования проекта, объясняет сложные идеи и обеспечивает общее понимание. 1
• Поддержка обмена знаниями и непрерывности проекта. 1 Документация сохраняет важные знания о проекте, облегчает передачу информации, помогает новым членам команды освоиться и обеспечивает непрерывность проекта. 1
• Повышение качества программного обеспечения. 1 Правильное документирование помогает поддерживать и улучшать качество ПО. 1 Оно обеспечивает контекст для кода, облегчает его проверку, исправление ошибок и улучшение программного обеспечения. 1
• Поддержка принципов Agile. 1 Agile предполагает принятие изменений, создание ценности и эффективное сотрудничество. 1 Хорошая документация поддерживает эти принципы, развивается вместе с проектом и предоставляет нужное количество информации именно тогда, когда это необходимо. 1
• Поддержка гибкости и адаптируемости. 2 Гибкие проекты предполагают изменения и реагируют на меняющиеся потребности и ожидания клиентов и рынка. 2 Упрощённая документация позволяет команде документировать только то, что необходимо и актуально на данный момент, и корректировать документацию по мере изменения программного обеспечения. 2