b) обладают адекватным восприятием соответствующих команд операционной системы;
c) не имеют навыков работы с магнитными лентами в системе ABC.
С.5 Проект содержания документации
Содержание включает в себя следующее:
a) введение — концепция ABC и ее связь с системой (пять страниц);
b) обзор — общие функции системы ABC (три страницы);
c) установка ленты (пять страниц);
d) снятие ленты (пять страниц);
e) проблемы — руководство по определению дефектов, включая системные сообщения (четыре страницы);
f) словарь терминов и определений (одна страница);
g) указатель (одна страница).
Всего 24 страницы.
С.6 Номенклатура поставки
По окончании проекта должны быть поставлены следующие объекты:
a) 500 переплетенных копий руководства;
b) электронная копия всей документации на дискетах емкостью 1,44 Мбайт, диаметром 3,5 дюйма в формате DEF 3.0 (пригодная для распечатки документации на принтере);
c) электронная копия справочного текста.
С.7 Авторские права
Авторские права на все материалы принадлежат организации XYZ.
С.8 Транспортирование
Особых условий по транспортированию продукции не требуется.
С.9 Процесс разработки и контроль
При создании руководств пользователя системы ABC должны использоваться процедуры разработки и контроля, установленные в Руководстве по качеству организации XYZ.
С.10 Тиражирование
При производстве руководств пользователя системы ABC следует использовать типографскую систему DEF (версия 3.0). Графические материалы следует разрабатывать с использованием графического пакета JKL.
Виды экранов дисплея для системы ABC следует собрать в электронном виде, а их копии — внести в окончательный документ.
Содержание и указатель должны быть подготовлены и выпущены на системе DEF.
Копии фотошаблонов должны быть отпечатаны на лазерном принтере с плотностью печати 300 точек на дюйм; за отдельную плату они могут быть распечатаны на лазерном принтере высокого качества с плотностью печати 1275 точек на дюйм.
Каждое руководство должно быть выполнено в формате А4 с двусторонней печатью и сброшюровано так, чтобы была возможность заменять листы.
Переплет должен быть формата А4 и скреплен кольцами диаметром 25 мм. На обложке должны быть приведены распечатки экранов системы ABC.
Бумага для руководств должна быть матовой и иметь плотность 103 г/см2.
Справочные тексты должны быть разработаны с использованием макетирования в системе DEF.
С.11 Проектанты
Состав коллектива разработчиков и их обязанности приведены в таблице С.2.
Таблица С.2 — Проектанты
| Фамилия, имя | Роль | Обязанность |
|---|---|---|
| О'Брайен П. | Автор | Изучение плана и написание руководств |
| Коста А. | Редактор | Редактирование руководств |
| Ричардc Р. | Нормоконтролер | Проверка технического содержания руководств |
| Джонс Е. | Технический аудитор | Проведение технических проверок и выдача рекомендаций |
| Вонг С. | Разработчик | Набор текста и подготовка графических материалов |
| Келли А. | Ответственный за качество | Управление качеством |
| Даунc М. | Ответственный за тестирование | Тестирование готового руководства при определенных условиях и подготовка отчета о результатах тестирования |
С.12 Ресурсы
Информацию, необходимую для разработки руководств, следует выбирать из проектной документации на систему ABC, получать от разработчиков программных средств и отбирать по результатам опытной эксплуатации данной системы.
Разработчикам документации необходимы следующие ресурсы:
a) копии функциональной проектной документации на систему ABC;
b) доступ к системе ABC;
c) доступ к разработчикам программного обеспечения системы ABC.
С.13 Тестирование на практичность
После корректировки второго проекта документации по замечаниям заказчика должно быть проведено тестирование на практичность руководства пользователя и справочных текстов для системы ABC.
Целью тестирования является оценка степени, в которой язык, содержание и оформление руководства пользователя и справочных текстов для системы ABC облегчают пользователям практическое применение программных средств данной системы.
Тестирование должно проводиться в машинном зале с использованием бета-версии тестов для ABC; в тестировании должно участвовать по одному представителю от разработчиков программных средств и разработчиков документации (далее — представители).
Тестирование должно проводиться с привлечением четырех типовых пользователей, перечисленных в С.4, выбранных произвольно из персонала ночной смены, эксплуатирующего систему. Каждому из них должны быть даны копии руководства пользователя и справочных текстов для системы ABC с просьбой выполнить ряд действий (перечисленных в плане тестирования).
Представители записывают время выполнения каждого действия, замечания пользователя и процессы, выполняемые пользователями при реализации каждого действия.
При превышении любым пользователем времени выполнения действия, указанного в плане тестирования, или неправильном выполнении данного действия представители записывают соответствующие замечания пользователя о причинах возникшей проблемы.
Эти замечания представляются на совещании по рассмотрению документации и в качестве изменений в проект документации. На совещании определяют целесообразность проведения повторного тестирования.
С.14 График работ
График работ показан в таблице С.З.
Таблица С.З — График работ
| Этап | Срок | Отношения |
|---|---|---|
| Представление первого проекта | 01.01.99 | План документирования утвержден 15.12.98 |
| Представление второго проекта | 15.02.99 | Три недели на проверку первого проекта |
| Тестирование на практичность | 15.03.99 | |
| Представления справочных текстов | 15.04.99 | Тестирование на практичность |
| Представление гранок | 15.04.99 | Тестирование на практичность; две недели на проверку второго проекта |
| Подготовка фотошаблонов | 30.04.99 | Тестирование на практичность |
| Распечатка и брошюровка | 15.05.99 | Наличие переплетенных томов |
ПРИЛОЖЕНИЕ D (справочное)
Отношения между аудиториями, выданными заданиями, бумажной и диалоговой документацией
Проектирование документации начинается с анализа пользователей документируемой системы. Как правило, существуют определенные группы пользователей, объединяемые в определенные аудитории в соответствии с их потребностями.