b) изучение и проверку содержания (плана-проспекта);
c) подготовку пробного куска текста для редактора;
d) редактирование пробного куска текста и его переписывание по замечаниям редактора;
e) написание всей первой редакции документации;
f) редактирование всей первой редакции документации;
g) переработку отредактированной документации;
h) изучение и проверку переработанной документации.
Иллюстративные материалы готовят одновременно с текстом первой редакции.
F.3.5 Вторая редакция
Период второй редакции охватывает:
a) внесение в документацию всех изменений, предложенных по результатам проверки первой редакции;
b) повторное (второе) редактирование второй редакции документации;
c) переработку отредактированной документации;
d) изучение и проверку переработанной документации.
F.3.6 Принятая редакция
Редакцией для фотонабора является принятая редакция документирования. Ее подготовка охватывает:
a) внесение в документацию всех изменений, предложенных по результатам проверки второй редакции;
b) проверку правильности внесения данных изменений;
c) удаление всех редакционных разметок;
d) изготовление фотошаблонов;
e) отправку фотошаблонов в печать (в типографию).
Обычно экспертам (нормоконтролерам) требуется от одной до двух недель для изучения и подготовки замечаний, а сама проверка занимает от одного до нескольких дней.
Метод нисходящего проектирования может быть использован для существующих публикаций. Например, книга объемом 100 страниц может быть переработана так, что половина ее изменяется и добавляется 10 % новых материалов. Используя вышепринятые допущения, получаем: 50/44 = 1,13 чел./мес для существующего материала плюс 10/22 = 0,45 чел./мес для внесения нового материала.
Когда сроки, необходимые для создания документации, превышают допустимые, для выполнения задания следует привлекать несколько авторов. Так же следует поступать при подготовке нескольких документов для одного программного средства.
ПРИЛОЖЕНИЕ 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] |
| Цвет краски | Черный |
| Цвет, масса и вид бумаги | Белая, 80 г/см², матовая |
| Разделители | Нет |
| Переплет | Пластиковый комбинированный, с прозрачной верхней и черной нижней обложками, плотностью 200–260 г/см² |
| Метод воспроизведения и качество | Все материалы должны быть пригодными к фотокопированию и не иметь помарок и обесцвечиваний |
| Схема нумерации страниц | Страницы нумеруют в формате 1, 2, 3 и т. д., начиная с первой после обложки |
| Нумерация таблиц и рисунков | Рисунки нумеруют в формате «Рисунок 1», «Рисунок 2» и т. д., в порядке их появления в тексте документа. Таблицы нумеруют в формате «Таблица 1», «Таблица 2» и т. д., в порядке их появления в тексте документа |
| Число колонок | Одна |
| Сноски или концевые примечания | Не используют |
| Правила пагинации | Заголовки не должны попадать в конец страницы. Таблицы объемом менее страницы должны размещаться на одной странице. Каждый заголовок первого уровня должен располагаться вверху правой страницы |
| Правила плотности документа | Взаимосвязанные материалы следует размещать на одной странице или на ее обороте. Следует по возможности избегать использования подчеркивания, больших кусков, набранных жирным шрифтом, и текстов, целиком набранных заглавными буквами. Материалы должны занимать от 40 % до 60 % общего объема страницы |
| Вводные и вспомогательные материалы: | |
| - титульный лист | На титульном листе должно быть указано наименование продукции, ее версия, дата выпуска документа и название данного тома |