Единая система программной документации (ЕСПД)
Комплекс стандартов на автоматизированные системы
(КСАС)
Содержание и сфера применения
Единая система программной
документации (ЕСПД) - отечественный комплекс стандартов на программную документацию. В
профессиональном просторечии его еще называют 'девятнадцатым
гостом', что не совсем правильно, поскольку речь идет не об одном, а
примерно о 30 разных нормативно-технических документах.
В основном
стандарты ЕСПД содержат требования к составу, содержанию и оформлению
документов, описывающих программу на разных стадиях ее жизненного цикла. Кроме
того, несколько документов посвящено порядку хранения и обновления
документации.
Стандарты ЕСПД практически лишены методической
составляющей. Они не объясняют разработчику, как надо писать документацию,
чтобы она получилась полезной, понятной, информативной, удобной и т. д. Они
дают только перечень типов документов и список разделов первого уровня для
каждого из них. Правда, о каждом разделе сказано, какие сведения должны быть в
нем изложены.
Стандарты ЕСПД были приняты в конце 70-х годов и дошли до
нас в виде, близком к первоначальному. В них отражена практика работы
ведомственных вычислительных центров, где эксплуатировались большие ЭВМ.
Взаимодействие человека с компьютерной системой тогда было построено совсем не
так, как теперь, и осуществлялось через громоздкие пульты, перфокарты и
распечатки, а для 'простых смертных', решающих прикладные задачи, еще и при
посредничестве квалифицированного персонала. Надо ли долго объяснять,
насколько эти стандарты к настоящему времени устарели? Достаточно сказать, что
им неведомы такие распространенные сегодня документы, как руководство пользователя и руководство администратора.
И
все-таки ими продолжают активно пользоваться. Формально 'девятнадцатому' есть
современная альтернатива. Переведены на русский язык и приняты в России на
правах национальных некоторые стандарты ИСО/МЭК
в области системной и программной инженерии. Но крупные, в том числе,
государственные заказчики переходить на них не торопятся. Это можно объяснить
их косностью (или верностью традиции, как вам больше нравится), но лишь
отчасти.
Дело в том, каждый стандарт ЕСПД при небольшом (страницы три
максимум) объеме представляет собой набор довольно формальных и поэтому
легко проверяемых требований к документу или к комплекту
документации. Строго говоря, это не мешает разработчику документации писать
правильно оформленные глупости. Но поскольку ЕСПД четко определяет, из чего
должен состоять и как должен выглядеть результат, мы можем, по крайней мере,
сразу отклонить пачку бумаги, которая в эти рамки не вписывается. Что
существенно упрощает задачу сдачи-приемки документации как для заказчика, так
и для исполнителя.
Стандарты ИСО/МЭК, напротив, содержат много разумных
правил содержательного характера, но сложно представить себе процедуру их
формальной проверки. Впрочем, никто не мешает применять оба ряда стандартов
одновременно, благо, они касаются разных аспектов документирования и друг
другу практически не противоречат.
Состав нормативно-технических
документов
Приобретение стандартов
Официальные тексты стандартов
ЕСПД опубликованы на сайте Федерального агентства
по техническому регулированию и метрологии.