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