1.3. Планирование документирования проектов сложных программных средств

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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