Стандарт ГОСТ 19.402-78 ЕСПД. Описание программы. Объяснение простым языком

Краткое назначение стандарта ГОСТ 19.402-78 ЕСПД. Описание программы

ГОСТ 19.402-78 задает правила и структуру для документа «Описание программы». Стандарт объясняет, какие разделы обязательно должны быть в документе: общие сведения, для чего нужна программа, как устроена её логика, какое железо требуется, как она запускается, а также какие данные программа принимает на вход и что выдает на выходе. Всё это нужно, чтобы описывать программы понятно и по единым правилам.

Область применения стандарта ГОСТ 19.402-78 ЕСПД. Описание программы

Требования стандарта ГОСТ 19.402-78 распространяются на любые программы и программные комплексы, которые разрабатываются в рамках Единой системы программной документации (ЕСПД) для компьютеров и вычислительных систем, независимо от того, где и для чего они будут использоваться.

Основные термины в стандарте ГОСТ 19.402-78 ЕСПД. Описание программы

Вот главные понятия и разделы, из которых состоит описание программы по ГОСТу:

• Описание программы – документ, который объясняет, как устроена программа, какова её логика и как она работает.
• Общие сведения – обязательный раздел, где указаны название и шифр программы, нужный софт и языки программирования.
• Функциональное назначение – обязательный раздел о том, какие задачи решает программа и какие есть ограничения в её работе.
• Описание логической структуры – обязательный раздел с описанием алгоритмов, методов и того, как между собой связаны части программы и другие сопутствующие программы.
• Используемые технические средства – обязательный раздел документа.
• Вызов и загрузка – обязательный раздел документа.
• Входные данные – обязательный раздел документа.
• Выходные данные – обязательный раздел документа.

Краткое содержание стандарта ГОСТ 19.402-78 ЕСПД. Описание программы

Стандарт ГОСТ 19.402-78 входит в комплекс ЕСПД и определяет, как правильно оформлять документ «Описание программы». Он полностью соответствует международному стандарту СТ СЭВ 2092-80.

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

Обязательные разделы описания программы
По стандарту документ должен включать следующие разделы:
1. Общие сведения – название и шифр программы, софт для её работы и языки программирования.
2. Функциональное назначение – задачи, которые решает программа, и ограничения в её применении.
3. Описание логической структуры – алгоритмы, методы и устройство программы: как связаны её части между собой и с другим софтом (описывается на основе исходного кода).
4. Используемые технические средства – требования к оборудованию.
5. Вызов и загрузка – как запускать программу и загружать её в память.
6. Входные данные – с какими данными и в каком формате работает программа.
7. Выходные данные – какие результаты выдает программа.

Часто задаваемые вопросы (FAQ) по стандарту ГОСТ 19.402-78 «ЕСПД. Описание программы»

1. Что представляет собой стандарт ГОСТ 19.402-78 и каково его главное назначение?

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

2. С какими международными нормативными документами гармонизирован данный стандарт?

Ответ: ГОСТ 19.402-78 полностью соответствует международному стандарту СТ СЭВ 2092-80.

3. Обязательно ли включать в документ «Описание программы» информационную часть?

Ответ: Да. Аннотация и содержание в начале документа «Описание программы» являются обязательными.

4. Каковы требования к структуре и составу обязательных разделов документа?

Ответ: Документ должен содержать семь основных разделов:
1. Общие сведения.
2. Функциональное назначение.
3. Описание логической структуры.
4. Используемые технические средства.
5. Вызов и загрузка.
6. Входные данные.
7. Выходные данные.
Примечание: если программа нестандартная, можно добавлять новые разделы или объединять текущие.

5. Что именно должно быть указано в разделе «Общие сведения»?

Ответ: Три пункта:
* Официальное название и шифр программы.
* Какое программное обеспечение (операционки, библиотеки) нужно для её работы.
* На каких языках программирования она написана.

6. Каково содержание разделов «Функциональное назначение» и «Описание логической структуры»?

Ответ:
* В «Функциональном назначении» пишут, для чего создана программа, какие задачи она решает и какие есть ограничения.
* В «Описании логической структуры» детально разбирают алгоритмы, математические методы, архитектуру и связи с другими программами, опираясь прямо на исходный код.

7. Что фиксируется в разделах «Используемые технические средства» и «Вызов и загрузка»?

Ответ:
* В «Технических средствах» перечисляют компьютеры, периферию и оборудование, нужное для работы.
* В «Вызове и загрузке» объясняют, как запустить программу с носителя, куда она загружается в память и какие у неё точки входа.

8. Как регламентируются разделы «Входные данные» и «Выходные данные»?

Ответ:
* В «Входных данных» описывают, откуда берутся исходные файлы, как они подготовлены и в каком формате передаются программе.
* В «Выходных данных» рассказывают, что именно программа выдает в результате и как выглядят эти готовые данные.

9. Допускается ли наглядная иллюстрация материалов и включение приложений?

Ответ: Да. Стандарт разрешает добавлять таблицы, схемы, графики и примеры, чтобы документ был нагляднее. Всё, что не поместилось в основные разделы, можно вынести в приложения.