Настоящий стандарт соответствует ГОСТ Р ИСО/МЭК 12207 в части реализации его подраздела 6.1 по отношению к документации пользователя (см. таблицу А.1).
Таблица А.1 — Перекрестные ссылки с ГОСТ Р ИСО/МЭК 12207
| Пункты ГОСТ Р ИСО/МЭК 12207 | Пункты настоящего стандарта |
|---|---|
| 6.1.1.1 | 8.1.3 План документирования |
| 6.1.2.1 | 8.2 Содержание спецификации стиля |
| 6.1.2.2 | 8.1.2 Представление исходных материалов |
| 6.1.2.3 | 8.1.4 Проверка (анализ) |
| 6.1.3.1 | 8.2 Содержание спецификации стиля. 8.1.3 План документирования |
| 6.1.3.2 | 8.1.3.3 Проверка плана документирования |
| 6.1.4.1 | 8.1.7 Контроль изменений и сопровождение документации |
ПРИЛОЖЕНИЕ В (справочное)
Использование настоящего стандарта в договоре
B.1 Общие положения
В настоящем стандарте имеются разделы, требования которых необходимо пояснить применительно к конкретному договору или другим ссылочным документам (например, международным). В свою очередь, план документирования также нуждается в пояснении. В договоре должны быть даны ответы на следующие вопросы:
a) откуда поступает информация о изучении аудитории? (Ответ рекомендуемый);
b) необходимо ли готовить более двух проектов комплекта документации и одного комплекта гранок?
(При необходимости, в настоящем стандарте по умолчанию предусмотрены два проекта комплектов документации и один комплект гранок);
c) кто представляет исходные материалы? (Обычно это очевидно, но для проектов со сложными взаимосвязями между вовлеченными сторонами нуждается в уточнении);
d) какие уровни конфиденциальности или секретности необходимо использовать для материалов, предоставляемых заказчиком документатору?
e) имеется ли стандарт на оформление бумажной документации? (Это не обязательно; по умолчанию может быть использована спецификация стиля документации, установленная в настоящем стандарте; затем в плане документирования может быть оговорено количество проектов документации и т. д.).
B.2 Образец раздела договора
В соответствии с настоящим стандартом образец раздела договора может быть представлен в следующем виде.
Пример
Раздел 123 Документация
Вся документация пользователя должна соответствовать ГОСТ Р ИСО/МЭК 15910.
В комплект документации не следует включать диалоговую документацию и справочные тексты. Вся информация об изучении аудитории и другие исходные материалы должны представляться заказчиком.
Должно быть проведено одно тестирование на практичность при поставке первого модуля программного средства, которое должно предусматривать проверки всех функциональных возможностей данного модуля в интересах пяти различных типовых пользователей.
В.З Практическое применение настоящего стандарта
Необходима адаптация настоящего стандарта в интересах потребителей и пользователей в целях его практического применения.
Практическое применение настоящего стандарта обычно заключается в исключении и добавлении ряда разделов, что должно быть оговорено соответствующим соглашением (как правило, в договоре, но возможно и в плане документирования).
Практическое применение настоящего стандарта следует проводить тщательно, с учетом его общей структуры.
ПРИЛОЖЕНИЕ С (справочное)
Образец плана документирования. Документация пользователя для системы ABC — административного управления магнитными лентами
