4.4.4. Качество документации

Качество документации не регламентировано стандартом ISO 9126:1–4 и в характеристиках качества ПС отмечено только в составе практичности. Качество документации может оказывать сильное влияние на функциональную пригодность ПС в двух случаях: при непосредственном применении пользователем; при модификации и развитии комплекса программ.

По своему назначению и ориентации на определенные задачи и основные группы пользователей документацию ПС можно разделить на:

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

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

Первая группа документов отражает внутренние метрики качества ПС. Вторая группа документов содержит преимущественно описания внешних метрик и метрик в использовании.

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

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

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

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

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

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

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

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

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

Процессы выбора и установления шкал и мер для описания характеристик качества проектов ПС можно разделить на два этапа (рис.4.1):

Р ис.4.1. Этапы процесса выбора и установления мер и шкал характеристик качества ПС

• предварительный выбор, формализация и обоснование набора исходных данных, отражающих общие особенности потребителей и этапы ЖЦ проекта ПС, каждый из которых влияет на выбор определенных характеристик качества комплекса программ;

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

На первом этапе следует использовать всю базовую номенклатуру характеристик, субхарактеристик и атрибутов, стандартизованных в ISO 9126:1–4. Их описания желательно предварительно упорядочить по приоритетам с учетом назначения и сферы применения конкретного ПС. Далее необходимо с учетом специализации и профессиональных интересов выделить и ранжировать по приоритетам потребителей, которым необходимы определенные показатели качества ПС. Из широкой номенклатуры характеристик стандарта ISO 9126:1–4 следует выбирать те, которые необходимы с позиции различных потребителей этих данных:

• заказчиков, для которых важно оценивать ПС по значениям утвержденных в ТЗ и спецификациях характеристик, определяющих назначение, функции и сферу применения ПС;

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

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

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

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

Таблица 4.4

Пример ранжирования важности характеристик ПС для различных категорий специалистов

	Функциональные возможности	Надежность	Эффективность	Практичность	Сопровождаемость	Мобильность
Заказчик	Высокая	Высокая	Высокая	Высокая	Средняя	Средняя
Пользователи	Высокая	Высокая	Высокая	Высокая	Низкая	Низкая
Сопровождающие	Средняя	Средняя	Средняя	Высокая	Высокая	Низкая
Специалисты по переносу	Высокая	Средняя	Высокая	Средняя	Низкая	Высокая

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

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

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

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

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

На втором этапе (рис.4.1) после фиксирования исходных данных и приоритетов для конкретного проекта и его потребителя начинаются процессы выбора номенклатуры атрибутов качества. Этот анализ совместно с заказчиком и пользователями должны проводить специалисты, обеспечивающие ЖЦ комплекса программ и реализацию установленных показателей качества.

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

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

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