Стандарт ГОСТ 19.202-78 ЕСПД. Спецификация. Требования к содержанию и оформлению. Объяснение простым языком
Краткое назначение стандарта ГОСТ 19.202-78 ЕСПД. Спецификация. Требования к содержанию и оформлению
ГОСТ 19.202-78 определяет, как должна выглядеть и составляться «Спецификация» – главный документ для программных комплексов и компонентов, которые работают сами по себе. В документе обязательно выделяются разделы: документация, комплексы и компоненты, которые оформляются в виде заголовков.
Область применения стандарта ГОСТ 19.202-78 ЕСПД. Спецификация. Требования к содержанию и оформлению
Согласно ГОСТ 19.202-78, спецификация – это основной документ для программных комплексов и самостоятельно работающих компонентов. Стандарт применяется во всей сфере разработки программного обеспечения и документации в рамках Единой системы программной документации (ЕСПД).
Основные термины в стандарте ГОСТ 19.202-78 ЕСПД. Спецификация. Требования к содержанию и оформлению
В тексте ГОСТ 19.202-78 используются следующие ключевые понятия:
- Спецификация – главный документ для программных комплексов и самостоятельных компонентов, который описывает их состав.
- Компонент – отдельная программа, которая решает конкретную задачу и может работать сама по себе или в составе комплекса.
- Комплекс – программа, которая состоит из двух или более компонентов (или других комплексов).
- Текст программы – главный документ для тех компонентов, у которых нет собственной спецификации.
- Документация – первый обязательный раздел спецификации.
- Компоненты – третий обязательный раздел спецификации.
Краткое содержание стандарта ГОСТ 19.202-78 ЕСПД. Спецификация. Требования к содержанию и оформлению
ГОСТ 19.202-78 входит в семейство стандартов ЕСПД и задает правила составления спецификации. Этот стандарт полностью соответствует международному стандарту СТ СЭВ 2090-80.
Основные положения и роль спецификации
* Спецификация – это главный документ для программных комплексов и компонентов, работающих автономно.
* Если у программного компонента нет своей спецификации, его главным документом считается «Текст программы».
* Стандарт содержит обязательное приложение с готовой формой спецификации.
* Общий вид и структуру документа нужно оформлять по ГОСТ 19.105-78.
* Информационную часть (аннотацию и содержание) можно не добавлять в спецификацию.
Содержание и разделы спецификации
Обычно спецификация включает три обязательных раздела:
1. Документация – список всех документов, которые относятся к программе.
2. Комплексы – список программных комплексов в составе изделия.
3. Компоненты – список входящих в состав программных компонентов.
Названия этих разделов пишутся в графе «Наименование». Если документ напечатан, заголовки разделов нужно обязательно подчеркнуть.
Часто задаваемые вопросы (FAQ) по стандарту ГОСТ 19.202-78 «ЕСПД. Спецификация. Требования к содержанию и оформлению»
1. Что представляет собой стандарт ГОСТ 19.202-78 и каково его главное назначение?
Ответ: ГОСТ 19.202-78 – это государственный стандарт ЕСПД. Он определяет единые правила, форму и порядок того, как нужно составлять и оформлять документ «Спецификация».
2. С какими международными нормативными документами гармонизирован данный стандарт?
Ответ: ГОСТ 19.202-78 полностью повторяет требования международного стандарта СТ СЭВ 2090-80.
3. Какова роль спецификации в составе программной документации и для каких объектов она обязательна?
Ответ: Спецификация – это главный документ для самостоятельных программных компонентов и крупных программных комплексов.
4. Какой документ является основным, если у конкретного программного компонента нет спецификации?
Ответ: Если отдельной спецификации у компонента нет, главным документом для него становится «Текст программы».
5. Как регламентируются общая структура и правила оформления спецификации?
Ответ: Структура и базовые правила оформления прописаны в стандарте ЕСПД ГОСТ 19.105-78, а точная форма спецификации приведена в приложении к самому ГОСТ 19.202-78.
6. Обязательно ли включать в спецификацию информационную часть (аннотацию и содержание)?
Ответ: Нет, не обязательно. Стандарт разрешает не включать аннотацию и содержание в спецификацию.
7. Какие обязательные разделы должна содержать спецификация в общем случае?
Ответ: Спецификация должна состоять из трех разделов:
1. Документация.
2. Комплексы.
3. Компоненты.
8. Каковы правила оформления заголовков разделов в спецификации?
Ответ: Название каждого раздела пишется в графе «Наименование». В печатных документах эти заголовки обязательно подчеркиваются.
9. Какую практическую функцию выполняет спецификация при разработке и комплектации ПО?
Ответ: Спецификация работает как опись или оглавление программы. Она собирает воедино всю техдокументацию, компоненты и комплексы, помогая легко разобраться в структуре ПО, проверить комплектность и передать проект заказчику.