7.7.1. Документирование в процессах жизненного цикла

Документирование в процессах ЖЦ ПС определяется стандартами ГОСТ серий 19 и 34, ISO/IEC 8631, ISO 9127, ISO/IEC 9294, ISO 15910, ISO 18019 (рис.2.2).

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

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

В процессе установления стратегии, стандартов и руководств по документированию необходимо осуществить и оценить:

• выбор модели ЖЦ ПС, состава и назначения его документов;

• типы, содержание и степень детализации каждого документа;

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

• содержание форматов и системы обозначения документов;

• распределение ресурсов: персонала; технических средств; финансов; на планирование документирования.

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

• официальными отчетами и руководствами по принятой стратегии документирования конкретного проекта ПС;

• стандартами и нормативными документами, определяющими все аспекты документирования программ и данных;

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

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

• планами документирования как органической части всего ЖЦ конкретного ПС.

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

Для оценивания качества документирования на каждом этапе ЖЦ ПС необходимо фиксировать и документально оформлять:

• исходные данные, требующиеся для успешного выполнения данного этапа документирования;

• контролируемые и документируемые данные о состоянии объекта и процесса ЖЦ ПС, регистрируемые после завершения этапа;

• содержание процедур оценивания состояния проекта и документов в процессе выполнения работ этапа;

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

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

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

• цели обеспечения качества;

• оцениваемые характеристики, субхарактеристики и атрибуты объекта разработки;

• контролируемые показатели процесса выполнения плана;

• методы управления реализацией плана;

• состав отчетной документации о результатах выполнения плана и достигнутых характеристиках качества.

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

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

• процессы ЖЦ создаваемой информационной системы;

• требования к системе и к ПС;

• организационные процедуры и стратегии документирования;

• размер, критичность и типы компонентов системы;

• количество задействованного персонала.

Должны быть учтены особенности:

• пользователей;

• поддерживающего персонала;

• руководителей контракта;

• потенциальных покупателей.

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