Экономические и правовые аспекты информационных технологий

9.47.Система стандартов на программную документацию

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

– упрощение процесса разработки, повышение надежности и снижение стоимости;

– упрощение понимания программ сторонними лицами (уменьшает число ошибок, упрощает эксплуатацию и сопровождение и т.п.);

– улучшение подготовки новых кадров.

В настоящее время действует Единая система программной документации (ЕСПД) представляющая собой комплекс государственных стандартов, устанавливающих правила разработки и оформления программ.

Стандарты ЕСПД подразделены на группы:

Код группы	Наименование группы
0	Общие положения
1	Основополагающие стандарты
2	Правила выполнения документации разработки
3	Правила выполнения документации изготовления
4	Правила выполнения документации сопровождения
5	Правила выполнения эксплуатационной документации
6	Правила обращения программной документации
7,8	Резервные группы
9	Прочие стандарты

Обозначения стандартов ЕСПД строятся по классификационному признаку. Они состоят из:

– номера 19, присвоенного классу стандартов ЕСПД;

– одной цифры (после точки), обозначающей код классификационной группы стандартов (как показано в таблице);

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

– двухзначного числа (после тире), указывающего год регистрации стандарта.

Например, стандарт «ЕСПД. Общие положения» имеет обозначение ГОСТ 19.001 – 77, а стандарт «ЕСПД. Текст программы. Требования к содержанию и оформлению» – ГОСТ 19.401 – 78.

9.48.Виды программ и программных документов

Стандарт определяет следующие основные понятия:

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

Программа – алгоритм, записанный в форме, воспринимаемой вычислительной машиной.

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

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

Программное изделие – программа на носителе данных, являющаяся продуктом промышленного производства.

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

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

С точки зрения документирования ЕСПД выделяет два вида программ:

1) Компонент – программа, рассматриваемая как единое целое, выполняющая законченную функцию и применяемая самостоятельно или в составе комплекса.

2) Комплекс – программа, состоящая из двух или более компонентов и (или) комплексов, выполняющих взаимосвязанные функции, и применяемая самостоятельно или в составе другого комплекса.

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

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

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

Среди эксплуатационных документов можно выделить:

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

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

3. Руководство программиста – содержит сведения для эксплуатации программы.

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

Допускается объединять отдельные виды эксплуатационной документации. Необходимость объединения указывается в техническом задании.