Наличие ошибок в документации может привести к разрыву во взглядах заинтересованных сторон и инженеров, и в результате предлагаемое решение не будет соответствовать ожиданиям заинтересованных сторон.Следовательно, менеджеры должны уделять большое внимание качеству документации.
Гибкий и водопадный подходы
Типы документации, которую создает группа, и ее объем в зависимости от выбранного подхода к разработке программного обеспечения. Есть два основных: проворный и водопадный. Каждый из них уникален с точки зрения сопроводительной документации.
Специалисты используют линейный метод с четкими целями для каждой фазы разработки. Команды, использующие водопад, тратят разумное количество времени на планирование продукта на ранних этапах проекта. Они создают обширный обзор основных целей и задач и планируют, как будет выглядеть рабочий процесс. Команды стремятся создать подробную документацию до начала любого из этапов проектирования. Тщательное планирование хорошо работает для проектов с небольшими изменениями или без них, поскольку оно позволяет точно составлять бюджет и оценивать время. Однако планирование водопада оказалось неэффективным для долгосрочного развития, так как оно не учитывает возможные изменения и непредвиденные обстоятельства на ходу. По данным исследования KPMG Global Agile Survey й81% компаний инициировали Agile-трансформацию за последние три года.
Ловкий подход основан на совместной работе, тесном сотрудничестве с клиентами и заинтересованными сторонами, гибкость и способность быстро реагировать на изменения. Основные строительные блоки гибкой разработки — это итерации; каждый из них включает планирование, анализ, проектирование, разработку и тестирование. Вначале гибкий метод не требует исчерпывающей документации. Менеджерам не нужно много планировать заранее, потому что все может измениться по мере развития проекта. Это позволяет осуществлять планирование точно в срок. Как следует из одной из ценностей компании, поставив «работающее программное обеспечение над исчерпывающей документацией», идея состоит в том, чтобы создавать документацию с информацией, которая необходима для продвижения вперед, когда это имеет наибольший смысл.
Сегодня это является наиболее распространенной практикой в разработке программного обеспечения, поэтому мы сосредоточимся на практике документации, связанной с этим методом.
Основная цель эффективной документации — гарантировать, что разработчики и заинтересованные стороны двигаются в одном направлении для достижения целей проекта. Для их достижения существует множество типов документации.
