Лекция 7

(4 часа)

Стандарты еспд. Основные положения гост 19.701-90 еспд

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

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

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

а) формулировку задачи, для решения которой разработана данная программа;

б) схему алгоритма решения задачи, представленную любым из известных способов, или описание логики работы программы в какой-либо другой форме;

в) листинг программы (отпечатанный текст) с подробными комментариями;

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

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

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

В обозначение стандарта ЕСПД ( и ЕСКД) должны входить:

- цифры 19, присвоенные классу стандартов ЕСПД (цифра 2, присвоенная классу стандартов ЕСКД);

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

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

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

Единая система программной документации (ЕСПД) - это ком­плекс государственных стандартов, устанавливающих взаимоувязан­ные правила разработки, обращения, оформления программ и про­граммной документации ( по ГОСТ 19.001-71)

Требования стандартов ЕСПД предъявляются к оформлению программ и программной документации в любой области, где при­меняются вычислительные машины.

Стандарты ЕСПД устанавливают:

• применяемые в науке, технике, производстве термины и определения основных понятий единой системы программной документации. Для каждого понятия установлен один стандартизированный термин (алгоритм, программа вычислительной машины, программирование, документ, программное изделие, программный документ, эксплуатационный программный документ, проверка программы, отладка программы, испытание программы, настройка программы и др.);

• виды программ (компонент, комплекс) и программных документов независимо от их назначения и области применения (текст программы, описание программы, программа и методика испытаний, техническое задание, пояснительная записка-схема алгоритма, руководство программиста, руководство оператора и др.);

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

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

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

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