Комплекс стандартов на автоматизированные системы (КСАС)

Содержание и сфера применения

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

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

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

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

И все-таки ими продолжают активно пользоваться. Формально «девятнадцатому» есть современная альтернатива. Переведены на русский язык и приняты в России на правах национальных некоторые стандарты ИСО/МЭК в области системной и программной инженерии. Но крупные, в том числе, государственные заказчики переходить на них не торопятся. Это можно объяснить их косностью (или верностью традиции, как вам больше нравится), но лишь отчасти.

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

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

Состав нормативно-технических документов

Обозначение Наименование
ГОСТ 19.001-77 Единая система программной документации.
Общие положения
ГОСТ 19.002-80 Единая система программной документации.
Схемы алгоритмов и программ. Правила выполнения
ГОСТ 19.004-80 Единая система программной документации.
Термины и определения
ГОСТ 19.005-85 Единая система программной документации.
Р-схемы алгоритмов и программ. Обозначения условные графические и правила выполнения
ГОСТ 19.101-77 Единая система программной документации.
Виды программ и программных документов
ГОСТ 19.102-77 Единая система программной документации.
Стадии разработки
ГОСТ 19.103-77 Единая система программной документации.
Обозначение программ и программных документов
ГОСТ 19.104-78 Единая система программной документации.
Основные надписи
ГОСТ 19 105-78 Единая система программной документации.
Общие требования к программным документам
ГОСТ 19.106-78 Единая система программной документации.
Требования к программным документам, выполненным печатным способом
ГОСТ 19.201-78 Единая система программной документации.
Техническое задание. Требования к содержанию и оформлению
ГОСТ 19.202-78 Единая система программной документации.
Спецификация. Требования к содержанию и оформлению
ГОСТ 19.301-79 Единая система программной документации.
Программа и методика испытаний. Требования к содержанию и оформлению
ГОСТ 19.401-78 Единая система программной документации.
Текст программы. Требования к содержанию и оформлению
ГОСТ 19.402-78 Единая система программной документации.
Описание программы
ГОСТ 19 403-79 Единая система программной документации.
Ведомость держателей подлинников
ГОСТ 19.404-79 Единая система программной документации.
Пояснительная записка. Требования к содержанию и оформлению
ГОСТ 19.501-78 Единая система программной документации.
Формуляр. Требования к содержанию и оформлению
ГОСТ 19.502-78 Единая система программной документации.
Описание применения. Требования к содержанию и оформлению
ГОСТ 19.503-79 Единая система программной документации.
Руководство системного программиста. Требования к содержанию и оформлению
ГОСТ 19.504-79 Единая система программной документации.
Руководство программиста. Требования к содержанию и оформлению
ГОСТ 19.505-79 Единая система программной документации.
Руководство оператора. Требования к содержанию и оформлению
ГОСТ 19.506-79 Единая система программной документации.
Описание языка. Требования к содержанию и оформлению
ГОСТ 19.507-79 Единая система программной документации.
Ведомость эксплуатационных документов
ГОСТ 19.508-79 Единая система программной документации.
Руководство по техническому обслуживанию. Требования к содержанию и оформлению
ГОСТ 19.601-78 Единая система программной документации.
Общие правила дублирования, учета и хранения
ГОСТ 19.602-78 Единая система программной документации.
Правила дублирования, учета и хранения программных документов, выполненных печатным способом
ГОСТ 19.603-78 Единая система программной документации.
Общие правила внесения изменений
ГОСТ 19.604-78 Единая система программной документации.
Правила внесения изменений в программные документы, выполненные печатным способом

Приобретение стандартов

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