ГОССТАНДАРТ РОССИИ - Информационная технология ПРОЦЕСС СОЗДАНИЯ ДОКУМЕНТАЦИИ ПОЛЬЗОВАТЕЛЯ ПРОГРАММНОГО СРЕДСТВА

Должен быть указан метод переплетения документации.

Должна быть определена схема нумерации страниц.

Примечания

1 Каждая страница должна иметь индивидуальный номер. Номера страниц должны быть проставлены в порядке их брошюрования.

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

3 В случае брошюровки документа без замены страниц используют порядковую нумерацию, например «1», «2» и т. д. Иногда для нумерации страниц содержания используют другую схему («i», «ii» и т. д.). Следует избегать схожих методов нумерации страниц вспомогательного (указателя и т. д.) и вводного материалов, так как это может привести к неоднозначности в случае изъятия или вставки страниц.

Должны быть определены схемы нумерации рисунков и таблиц (при необходимости их нумерации).

Примечание — Рисунки и таблицы в документе (частях документа) должны иметь индивидуальную нумерацию. Рисунки и таблицы должны нумероваться в порядке их расположения в документе (частях документа). Может быть использована единая, последовательная нумерация рисунков и таблиц.

Должны быть указаны возможности применения сносок или концевых примечаний.

Примечание — В документации пользователя программного средства данные элементы обычно не используют; в спецификации стиля следует запретить их применение.

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

Должны быть определены виды вводных и вспомогательных материалов, включая (при необходимости) требования к содержанию и оформлению:

a) титульного листа;

b) информации о гарантиях, авторских правах, компенсациях и торговой марке;

c) содержания;

d) списка рисунков и таблиц;

e) приложений;

f) словаря (глоссария);

g) перечней обозначений и сокращений;

п) указателя.

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

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

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

Должно быть указано число колонок, используемых при оформлении страниц документа.

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

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

Примечания

1 Для языков романской группы в тексте основной части документа следует избегать строк длиной более 65 и менее 30 символов.

2 Для подсчета соответствующей длины строки изначально выбирают строку длиной 5 см и считают количество символов (включая пробелы), содержащихся в десяти строках обычного текста (без разбивки на абзацы) данной длины. Полученное число делят на 50 для определения среднего числа символов на 1 см. Затем принимают решение о необходимом количестве символов в строке (которое должно быть между 30 и 65) и делят его на ранее определенное среднее число символов на 1 см для получения необходимой длины строки в сантиметрах.