4.4.3Виды стандартных программных документов

Программные документы и их содержание:

• спецификация – перечень и назначение всех файлов ПС, включая файлы документации;

• ведомость держателей подлинников – список предприятий, хранящих подлинники программных документов, составляется только для сложных ПС;

• текст программы – запись кодов программы и комментарии к ним;

• описание программы – информация о логической структуре и функционировании программы;

• программа и методика испытаний – перечень и описание требований, которые должны быть проверены в ходе испытания программы, методы контроля;

• техническое задание – документ, в котором излагаются назначение и область применения программы, требования к ПС, стадии и сроки разработки, виды испытаний;

• пояснительная записка – обоснование принятых и примененных технических и технико-экономических решений, схемы и описание алгоритмов, общее описание работы ПС.

К программным документам отнесены также документы, обеспечивающие функционирование и эксплуатацию программ – эксплуатационные документы:

• ведомость эксплуатационных документов – содержит список эксплуатационных документов на ПС, к которым относятся формуляр, описание применения, руководство системного программиста, руководство программиста, руководство оператора, описание языка, руководство по техническому обслуживанию;

• формуляр – содержит основные характеристики ПС, состав и сведения об эксплуатации программы;

• описание применения – содержит информацию о назначении и области применения ПИ, ограничениях при применении, классе и методах решаемых задач, конфигурации технических средств;

• руководство системного программиста – содержит сведения для проверки, настройки и функционирования программы при конкретном применении;

• руководство программиста – содержит сведения для эксплуатации ПС;

• руководство оператора – содержит подробную информацию для пользователя, обеспечивающую его общение с ЭВМ в процессе выполнения ПС;

• описание языка – содержит синтаксис и семантику языка;

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

Необходимость составления остальных документов устанавливается при разработке и утверждении технического задания (ТЗ).

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

Большую роль для унификации при программировании играет стандарт ГОСТ 19.701-90 (ИСО 5807-85) «Схемы алгоритмов, программ, данных и систем», где приведены условные обозначения в схемах алгоритмов, программ, данных и систем, устанавливаются правила выполнения схем для решения различных задач. В этом стандарте описаны последовательности описания схем:

• данных (отображают путь данных, этапы обработки, носители);

• программы (отображают последовательность операций в программе);

• работы системы (отображают управление операциями и поток

• данных в системе);

• взаимодействия программ (отображают путь активаций программ и взаимодействий с соответствующими данными);

• ресурсов системы (отображают конфигурацию блоков: данных и обрабатывающих).

Виды программных документов и их содержание

Код	Вид программного документа	Содержание программного документа
-	Спецификация	Состав программы и документации на нее
05	Ведомость держателей подлинников	Перечень предприятий, на которых хранят подлинники программных документов
12	Текст программы	Запись программы с необходимыми комментариями
13	Описание программы	Сведения о логической структуре и функционировании программы
51	Программа и методика испытаний	Требования, подлежащие проверке при испытании программы, а также порядок и методы их контроля
-	Техническое задание	Назначение и область применения программы, технические, технико-экономические и специальные требования, предъявляемые к программе, необходимые стадии и сроки разработки, виды испытаний
81	Пояснительная записка	Схема алгоритма, общее описание алгоритма и (или) функционирования программы, а также обоснование принятых технических и технико-экономических решений
-	Эксплуатационные документы	Сведения для обеспечения функционирования и эксплуатации программы

Виды эксплуатационных документов и их содержание

Код	Вид эксплуатационного документа	Содержание эксплуатационного документа
20	Ведомость эксплуатационных документов	Перечень эксплуатационных документов на программу
30	Формуляр	Основные характеристики программы, комплектность и сведения об эксплуатации программы
31	Описание применения	Сведения о назначении программы, области применения, применяемых методах, классе решаемых задач, ограничениях для применения, минимальной конфигурации технических средств
32	Руководство системного программиста	Сведения для проверки, обеспечения функционирования и настройки программы на условия конкретного применения
33	Руководство программиста	Сведения для эксплуатации программы
34	Руководство оператора	Сведения для обеспечения процедуры общения оператора с вычислительной системой в процессе выполнения программы
35	Описание языка	Описание синтаксиса и семантики языка
46	Руководство по техническому обслуживанию	Сведения для применения тестовых и диагностических программ при обслуживании технических средств