Лекция №2 Тема Виды документации

1.Единая система программной документации. Перечень документов ЕСПД.

2.Основное понятие и виды программной документации.

1.Основной целью установления регламентных норм является отсутствие нарушений прав потребителей программного изделия и их безопасность. Регламентные нормы на программные изделия устанавливаются государственными законодательством и стандартами. Единая система программной документации — это комплекс Государственных стандартов России, устанавливающий взаимосвязанные правила разработки, оформления и обращения программ и программной документации. В стандартах ЕСПД устанавливаются требования, регламентирующие разработку, сопровождение, изготовление и эксплуатацию программ, что обеспечивает возможность: - унификации программных изделий для взаимного обмена программами и применения ранее разработанных программ в новых разработках; - снижения трудоемкости и повышения эффективности разработки, сопровождения изготовления и эксплуатации программных изделий; - автоматизации изготовления и хранения программной документации. Правила и положения, устанавливаемые в стандартах ЕСПД, распространяются на программы и программную документацию для вычислительных машин, комплексов и систем независимо от их назначения и областиприменения. Обозначение стандарта ЕСПД — ГОСТ 19.ХХХ–ХХ включает следующие элементы: ГОСТ (аббревиатура) — категория стандарта (государственный стандарт ); 19 (двузначное число) — код класса стандартов ЕСПД; . (точка) — разделитель; Х (цифра) — код классификационной группы стандарта;  ХХ (двузначное число) — порядковый номер стандарта в группе; – (тире) — разделитель: ХХ (двузначное число) — год регистрации стандарта. В состав ЕСПД входят стандарты, которые можно разделить на следующие классификационные группы (после наименования группы в скобках приводится ее код, а далее обозначения стандартов) Общие положения (0). 19.001–94. Основополагающие стандарты (1). ГОСТ 19.101–94, ГОСТ 19.102–94, ГОСТ 19.103–94, ГОСТ 19.104–94, Правила выполнения документации разработки (2). ГОСТ19.201–94,ГОСТ19.202–94, Правила выполнения документации изготовления (3). ГОСТ19.301–94, Правила выполнения документации сопровождения (4). ГОСТ 19.401–94, ГОСТ 19.402–94, ГОСТ 19.403–94,  ГОСТ19.404–94, Правила выполнения эксплуатационной документации (5). ГОСТ19.501–94,ГОСТ19.502–94,ГОСТ19.503–94, ГОСТ 19.504–94, ГОСТ 19.505–94,ГОСТ19.506–94, ГОСТ19.507–94,ГОСТ19.508–94, Правила обращения программной документации (6). ГОСТ19.601–94,ГОСТ19.602–94,ГОСТ19.603–94, ГОСТ19.604–94,Резервные группы (7,8). Прочиестандарты (9). В соответствии с требованиями, установленными в ГОСТ 19.001–94, разработка организационно-методической документации, определяющей и регламентирующей деятельность организаций по разработке, сопровождению и эксплуатации программ, должна проводиться на основе стандартов ЕСПД. П.1. Единая система программной документации.

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

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

     Вообще перечень документов ЕСПД очень обширен. В него, в частности, входят следующие ГОСТы: ГОСТ 19.001-77 ЕСПД. Общие положения. ГОСТ 19.101-77 ЕСПД. Виды программ и программных документов (переиздан в ноябре 1987г с изм.). ГОСТ 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.404-79 ЕСПД. Пояснительная записка. Требования к содержанию и оформлению. ГОСТ 19.501-78 ЕСПД. Формуляр. Требования к содержанию и оформлению. ГОСТ 19.502-78 ЕСПД. Описание применения. Требования к содержанию и оформлению. ГОСТ 19.503-79 ЕСПД. Руководство системного программиста. Требования к содержанию и оформлению. ГОСТ 19.504-79 ЕСПД. Руководство программиста. ГОСТ 19.505-79 ЕСПД. Руководство оператора. ГОСТ 19.506-79 ЕСПД. Описание языка. ГОСТ 19.508-79 ЕСПД. Руководство по техническому обслуживанию. Требования к содержанию и оформлению. ГОСТ 19.604-78 ЕСПД. Правила внесения изменений в программные документы, выполняемые печатным способом. ГОСТ 19.701-90 ЕСПД. Схемы алгоритмов, программ, данных и систем. Условные обозначения и правила выполнения. ГОСТ 19.781-90. Обеспечение систем обработки информации программное.

      Основная часть комплекса ЕСПД была разработана в 70-е и 80-е годы. Частично эти стандартны морально устарели, к тому же они не лишены некоторых недостатков. Во-первых, в них не отражены некоторые современные тенденции оформления программ и программной документации, во-вторых, в этих стандартах наличествует многократное дублирование фрагментов программной документации. Тем не менее, за неимением лучшего ориентироваться приходится именно на них.

     Итак, стандарты ЕСПД упорядочивают процесс документирования программных систем. Однако, во-первых, предусмотренный стандартами ЕСПД состав программных документов вовсе не такой "жесткий", как может показаться: стандарты позволяют вносить в комплект документации на программной системы (ПС) дополнительные виды, а, во-вторых, исходя из требований заказчика, допустимы некоторые изменения как в структуре, так и в содержании установленных видов ПД. Более того, можно отметить, что стандарты ЕСПД (а это относится и ко всем другим стандартам в области ПС - ГОСТ 34, Международному стандарту ISO/IEC, и др.) носят рекомендательный характер. Дело в том, что в соответствии с Законом РФ "О стандартизации" эти стандарты становятся обязательными на контрактной основе – т.е. при ссылке на них в договоре на разработку (поставку) ПС.

Стандарты ЕСПД  охватывают ту часть документации, которая создается в процессе разработки программы, и связаны с документированием функциональных . Впрочем, это относится и к другим стандартам в области разработки программ таким, как: ГОСТ 34, Международному стандарту ISO/IEC, и др. В соответствии с Законом РФ "О стандартизации" эти стандарты становятся обязательными только  на контрактной основе - то есть при ссылке на них в договоре на разработку программы.

Стоит заметить что, кроме ЕСПД  в официальной нормативной базе РФ в области документирования программ и в смежных областях есть  ряд перспективных стандартов, например:

- международный стандарт ISO/IEC 12207: 1995-08-01 на организацию жизненного цикла продуктов программного обеспечения.

- Стандарты комплекса ГОСТ 34 на создание и развитие автоматизированных систем.