Планування документування проектів

Общее руководство процессом документирования комплексов программ можно разделить на два уровня:

- адаптация состава и содержания документов к данной деловой, проблемно-ориентированной области, например, авиационной, медицинской, военной, финансовой или административной;

- адаптация номенклатуры, структуры и содержания документов для каждого специфического проекта, контракта или предприятия.

В соответствии со стандартами план документирования в виде совокупности руководящих, промежуточных и отчетных документов должен разрабатываться системными аналитиками и утверждаться менеджером проекта вместе со спецификацией требований к ПС.

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

При первичной оценке ресурсов, необходимых для документирования сложных проектов ПС наибольшее значение имеют три ключевых фактора:

- размер - масштаб, подлежащих разработке полностью новых программных компонентов и документов;

- размер и относительная доля готовых программных компонентов и документов, которые могут быть заимствованы из предшествовавших проектов и повторно использованы в новом проекте ПС;

- относительные затраты ресурсов на создание проекта с оцененным масштабом: труда специалистов, времени, бюджета на единицу размера (на строку текста программ) или полные затраты на разработку всего ПС и комплекса документов.

Эти факторы могут быть оценены квалифицированными экспертами на основе имеющегося у них опыта реализации предшествовавших подобных проектов, а также использования опубликованных данных

Оценивая масштаб, функции и требования к документации, заказчик и разработчики должны хотя бы приближенно представлять тот объем затрат и физический размер комплекса документации, который придется создать в процессе всего жизненного цикла ПС, а также для обеспечения его эффективного применения. Известно, что на документирование крупномасштабных ПС требуется до 20 - 30% общей трудоемкости создания таких проектов, а для относительно малых проектов около 10% трудоемкости. Представляет интерес оценка ориентировочного физического объема документации (например, в стандартных страницах А4 или эквивалентных объемов файлов) для проектов комплексов программ.

Большая часть этих документов может оставаться в файлах (сотни мегабайт), однако каждый документ должен быть оформлен в соответствии со стандартами и шаблонами, и скреплен подписями разработчиков и, где нужно, заказчика. Измеение этих документов должно санкционироваться, также как твердых копий. Для относительно малого ПС (50 тысяч строк) с минимальной технологической документацией может потребоваться около 5 тысяч страниц.

Приведенные оценки следует рассматривать только как ориентиры, которые в реальных проектах могут изменяться на порядок в ту или иную сторону, в зависимости от требований заказчика и характеристик проекта. Оценки объема предстоящей разработки технологической и эксплуатационной документации целесообразно проводить на этапе детального проектирования с учетом реальных характеристик ПС, что позволит избежать неприятных сюрпризов вызванных превышением затрат на реализацию документов проекта.

Менеджер проекта для оценок документации должен подготовить план выполнения документирования в жизненном цикле ПС. тот план должен содержать описания соответствующих работ и задач и обозначения создаваемых программных продуктов и документов. Он должен охватывать (но не ограничиваться) следующие задачи:

- установление графиков и сроков своевременного решения документирования;

- оценку необходимых трудозатрат на создание каждого документа и всего комплекса; определение времени, необходимого для выполнения конкретных задач документирования;

- распределение задач документирования по исполнителям;

- определение обязанностей исполнителей по созданию содержания документов;

- выделение критических ситуаций, связанных с задачами или самим процессом документирования;

- установление критериев управления и обеспечение качества документов;

- обеспечение внешних условий и определение инфраструктуры проекта системы для выполнения процесса документирования.

План документирования может быть частью общего плана жизненного цикла ПС или отдельным документом и должен быть доведен до всех участников проекта, в той части, которая их касается. План и поддерживающее его Руководство по документированию конкретного проекта ПС должны отражать:

- общую структуру комплекта документов;

- номенклатуру и содержание (или ссылки на шаблоны) каждого документа;

- требования к качеству, оформлению и обозначению документов;

- регламент комплектования и хранения документов;

- правила обращения, изменения и сопровождения документов;

- графики подготовки, проверки, редактирования, согласования, утверждения и распространения документов.

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

В каждой организации должна быть создана официальная система для сбора, анализа, обобщения, архивирования и поиска архивных данных и документов по проектам. Результатом сотрудничества заказчика и разработчика считается соглашение по требованиям к продукту и к документам.

Документ наилучшим образом представляет наше понимание требований к этому проекту и

Дата добавления: 2015-05-08