Госстандарт СССР - Единая система программной документации. ТРЕБОВАНИЯ К ПРОГРАММНЫМ ДОКУМЕНТАМ, ВЫПОЛНЕННЫМ ПЕЧАТНЫМ СПОСОБОМ

• Название: Единая система программной документации. ТРЕБОВАНИЯ К ПРОГРАММНЫМ ДОКУМЕНТАМ, ВЫПОЛНЕННЫМ ПЕЧАТНЫМ СПОСОБОМ
• Автор: Госстандарт СССР
• Жанр: Техническая литература

Unified system for program documentation. Requirements for printed documents

Настоящий стандарт устанавливает правила выполнения программных документов для вычислительных машин, комплексов и систем независимо от их назначения и области применения и предусмотренных стандартами Единой системы программной документации (ЕСПД) для печатного способа выполнения.

Стандарт не распространяется на программный документ «Текст программы».

Стандарт соответствует СТ СЭВ 2088-80 в части установления структуры и требований к изложению программных документов (см. справочное приложение 1).

---

Приложения оформляют как продолжение данного документа на последующих страницах или выпускают в виде отдельного документа.

2.9.2. Каждое приложение должно начинаться с новой страницы с указанием в правом верхнем углу слова „ПРИЛОЖЕНИЕ“ прописными буквами и иметь тематический заголовок, который записывают симметрично тексту прописными буквами.

При наличии в документе более одного приложения все приложения нумеруют арабскими цифрами (без знака №), например, ПРИЛОЖЕНИЕ 1, ПРИЛОЖЕНИЕ 2 и т. д.

При выпуске приложения отдельным документом на титульном листе под видом документа следует указывать слово „ПРИЛОЖЕНИЕ“, а при наличии нескольких приложений указывают также их порядковые номера.

Приложения, выпущенные в виде отдельного документа, обозначают как часть документа. При необходимости в таком приложении может быть помещено „Содержание“.

Допускается объединять несколько приложений в отдельную часть программного документа.

(Измененная редакция, Изм. № 1).

2.9.3. Содержание каждого приложения, при необходимости, разбивают на разделы, подразделы, пункты, нумеруемые отдельно по каждому приложению.

2.9.4. Нумерация страниц документа и приложений, входящих в состав документа, должна быть сквозная, если приложения не выполняются от дельным документом.

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

(Измененная редакция, Изм. № 1).

2.9.5. На приложения должны быть даны ссылки в основном тексте документа.

Все приложения должны быть перечислены в листе „Содержание“.

3. ТРЕБОВАНИЯ К ПРОГРАММНЫМ ДОКУМЕНТАМ. СОДЕРЖАЩИМ ТЕКСТ, РАЗБИТЫЙ НА ГРАФЫ

3.1. Программные документы, содержащие текст, разбитый на графы, при необходимости разделяют на разделы и подразделы, которые не нумеруют. Допускается линии, разграничивающие строки и графы, не наносить.

3.2. Наименования разделов и подразделов записывают в виде заголовков строчными буквами (кроме первой прописной) и подчеркивают.

Расстояния между заголовком и последующим текстом, между текстом и последующим заголовком и между заголовками должны соответствовать указанным в п. 2.1.8.

3.3. Примечания в документе оформляют в порядке, изложенном в п. 2.7.

3.4. В таблицах и формах, имеющих строки, все записи размещают на каждой строке в один ряд.

Записи не должны сливаться с линиями, разграничивающими строки и графы.

Следует оставлять свободные строки между разделами и подразделами, а в документах большого объема — также внутри разделов и подразделов.

Если в графе документа записан текст в несколько строк, то в последующих графах записи начинают на уровне первой строки. Допускается помещать запись на уровне последней строки, если она занимает одну строку.

(Измененная редакция, Изм. № 1).

ПРИЛОЖЕНИЕ 1 Справочное ИНФОРМАЦИОННЫЕ ДАННЫЕ О СООТВЕТСТВИИ ГОСТ 19.106-78 СТ СЭВ 2088-80

Разд. 1 ГОСТ 19.106-78 соответствует разд. 1 и разд. 4 (п. 4.1) СТ СЭВ 2088-80.

Разд. 2 ГОСТ 19.106-78 соответствует разд. 4 (пп. 4.4 — 4.9) СТ СЭВ 2088-80.

(Введено дополнительно, Изм. № 1).

ПРИЛОЖЕНИЕ 2 Справочное СТРУКТУРА ТЕКСТА ПРОГРАММНОГО ДОКУМЕНТА