Построение документа

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

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

Информационная и основная части программного документа выполняются по форме 1 или по форме 2 (см. рисунки 1.8, 1.7), где:

Поле 1 – порядковый номер страницы.

Поле 2 – обозначение документа.

Поле 3 – текст документа.

Поле 4 – строка изменений.

Рамку формата можно не наносить.

Рисунок 1.7 – Форма 2 Построения документа

Рисунок 1.8 – Форма 1 Построения документа

Аннотацию размещают на отдельной пронумерованной странице с заголовком «АННОТАЦИЯ», но не нумеруют как раздел. В аннотации указывают издание программы, кратко излагают назначение и содержание документа, общее количество частей документа (если их больше одной).

Содержание документа размещают на отдельной пронумерованной странице/страницах после аннотации, снабжают заголовком «СОДЕРЖАНИЕ», не нумеруют как раздел и включают в общее количество страниц документа. В содержание документа включают номера разделов, подразделов, пунктов и подпунктов, имеющих заголовок, их наименование и номера страниц; прочие наименования (перечень рисунков, таблиц и т.п.) и номера страниц. Наименования, включенные в содержание, записывают строчными буквами.

Структурными элементами текста документа являются разделы, подразделы, пункты, подпункты и перечисления.

1 Раздел – первая ступень деления, обозначенная номером и снабженная заголовком.

2 Подраздел – часть раздела, обозначенная номером и имеющая заго­ловок.

3 Пункт – часть раздела или подраздела, обозначенная номером. Может иметь заголовок.

4 Подпункт – часть пункта, обозначенная номером. Может иметь заго­ловок.

5Внутри подразделов, пунктов, подпунктов могут быть даны перечисления, которые рекомендуется обозначать арабскими цифрами со скобкой: 1), 2) и т.д. Допускается выделять перечисления простановкой дефиса перед текстом. Не рекомендуется делать ссылки на элементы перечисления.

6 Абзац – логически выделенная часть текста, не имеющая номера.

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

Заголовки разделов пишут прописными буквами и размещают по центру строки. Заголовки подразделов записывают с абзаца строчными буквами (кроме первой прописной). Переносы слов в заголовках не допускаются. Точку в конце заголовка не ставят, но если заголовок состоит из двух предложений, их разделяют точкой.

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

Разделы, подразделы, пункты и подпункты следует нумеровать арабскими цифрами с точкой. В пределах раздела должна быть сквозная нумерация по всем подразделам, пунктам и подпунктам, входящим в данный раздел.

Нумерация подразделов включает номер раздела и порядковый номер подраздела, входящего в данный раздел, разделенные точкой (2.1, 3..1 и т.д.).

При наличии разделов и подразделов к номеру подраздела после точки добавляют порядковый номер пункта и подпункта (3.1.1, 3.1.1.1 и т.д.).

На рисунке 1.9 приведен пример структуры текста программного документа и нумерация его разделов, подразделов, пунктов и подпунктов.

Рисунок 1.9 – Пример структуры текста программного документа
и его структурных элементов