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

ПРИЛОЖЕНИЕ G (справочное) Оценка плана документирования

Использование настоящего стандарта во взаимоотношениях между заказчиком и документатором способствует созданию качественной документации в частности потому, что между ними согласовывается план документирования. Этим достигается двойной эффект: во-первых, документатор учитывает все аспекты документации, оговоренные в плане; во-вторых, заказчик и документатор согласуют метод документирования, определенный в плане, еще до начала работы.

Заказчик должен установить наличие в плане документирования следующих элементов:

a) соответствующих определений всех аудиторий. Формулировка вида «Руководство предназначено для аудитории, охватывающей пользователей программного средства» неполна (см. приложение D). В определение аудитории должны быть включены все лица, могущие использовать данное программное средство (включая лиц, которые могут только просматривать отчеты или сообщения от данного средства);

b) содержания (планов-проспектов) документации с оценкой их постраничного объема;

c) определения числа печатных копий и методов печати (тиражирования) и брошюровки документации;

d) однозначного определения собственника авторских прав на документацию;

e) установление методов подготовки документации. Большинство технических документов может быть создано при помощи компьютера;

f) достаточных сроков для проверки заказчиком редакций документации. Любые отсрочки при возврате документатору проверенных редакций могут привести к срыву сроков поставки документации;

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

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

ПРИЛОЖЕНИЕ Н (справочное) Образец спецификации стиля

Н.1 Общие положения

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

Примечание — Перед окончательным принятием данной спецификации полезно создать на ее основе модель документа.

Н.2 Элементы стиля

В таблице Н.1 приведены элементы стиля и их рекомендуемые значения по умолчанию.

Таблица Н.1 — Элементы стиля и их значения

Язык	Английский
Орфографический словарь	Словарь Маквайра
Руководство по грамматике и использованию стиля	«Руководство по стилю для авторов, редакторов и издателей» Австралийское государственное издательство
Формат бумаги	A4
Ориентация	Книжная (вертикальная)
Вид печати	Двусторонняя
Разрешающая способность типографской или лазерной печати	Минимум 300 точек/дюйм
Ширина внутреннего поля	10 мм/2,4 цицеро[2]
Ширина внешнего поля	10 мм/2,4 цицеро[2]
Цвет краски	Черный
Цвет, масса и вид бумаги