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

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

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

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

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

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

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

Должен быть определен используемый размер бумаги.

Примечание — При выборе размера бумаги должно быть учтено следующее:

a) форматы А4, А5 и В5 указаны в настоящем стандарте (см. 4.1 и 4.5);

b) как будут храниться данные документы (в некоторых архивах возникают проблемы с хранением документов в конкретных форматах);

c) используются ли распечатки экранов (распечатки целых экранов в формате А5 недостаточно разборчивы);

d) используемый национальный стандартный формат бумаги, если документация представляется в виде фотокопий;

e) требования к мобильности и рабочей области документации.

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

Следует указать, будет ли документация печататься в одно- или двустороннем формате.

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

Должна быть определена минимально допустимая разрешающая способность печати (количество точек в 1 дюйме/1 мм).

Примечание — Минимально рекомендуемой является разрешающая способность 300 точек/дюйм.

Должно быть определено расстояние от полосы набора до корешка переплета.

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

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

Примечание — Если в плане документирования или в договоре указано несколько цветов, любой документатор, не компетентный в области многоцветной печати, должен заранее (до предъявления гранок заказчику) обратиться за консультацией к соответствующим специалистам.

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

Примечание — Если требуется конкретный номер бумаги, это должно быть указано.

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

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

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

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

Примечания

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

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

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

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

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

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

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

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

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