7.2.4.Требования к содержанию спецификации стиля документации

В стандарте ИСО/МЭК 15910 отражено содержание спецификации стиля
документации.
Спецификация	стиля	должна	содержать		правила	оформ
документации различных типов.
Например, для бумажных документов это может					быть компоновка
документа, заголовки,	шрифты,	перечень	вводных	и	вспомогательных

материалов, схемы нумерации страниц, таблиц, рисунков и т.п.

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

Стандарт ИСО/МЭК 15910 не определяет состава конкретных требований к оформлению документов, а определяет лишь содержание и диапазоны требований.

Для бумажных документов в спецификации стиля определены следующие вводные и вспомогательные материалы:

·титульный лист;

·информация о гарантиях, авторских правах и торговой марке;

·содержание;

·список рисунков и таблиц;

·приложения;

·словарь (глоссарий);

·перечень обозначений и сокращений;

·указатель.

Для электронных документов в спецификации стиля предусмотрены следующие типы справочной информации:

·контекстная справка (context help) – информация о текущем поле, в котором находится курсор или высвечена программа, включая ее

необходимое	или	предметное	содержание, назначение	и
потенциальное влияние на работу ПС;

·расширенная справка (extended help) – информация о текущем экране или окне, включая ее назначение и требуемый режим использования;

· справка о клавишах(keys help) – информация о применении клавиатуры, функциональном назначении клавиш и их обозначении;

·справка о справках(help to help) – информация об использовании справочной системы в целом;

·справка о сообщении(message help) – информация о возможных действиях пользователя в ответ на конкретные системные сообщения (например, сообщения об ошибках);

· терминологическая справка (reference phrase help) – определения конкретных элементов, связей с конкретной тематикой и расшифровка

175

обозначений и сокращений;

· понятийная справка (intelligent help) – справочная информация, выдаваемая системой для предупреждения пользователя об ошибках.

Для электронных документов в спецификации стиля предусмотрены также следующие типы диалоговой (оперативной) документации:

·руководства или рекомендации пользователя (user guide or reference) –

описывают процедуры по применению продукта;

·командные справки (command reference) – определяют синтаксис, результаты и целевое назначение каждой команды (только для команд управления системой);

·рекомендации по сообщению(message reference) – определяют действия пользователя в ответ на конкретные системные сообщения (например сообщения об ошибках);

· административная информация (administration information) –

информация для администратора системы о конфигурации и защите системы, при необходимости – о ее инсталляции.

176

ЛИТЕРАТУРА

1.	ISO/IEC	12207:1995.	Информационная	технология –	Процессы
жизненного цикла программных средств.
2.	ISO/IEC	15910:1999	– Информационная	технология –	Процесс
создания документации пользователя программного средства

3.ISO/IEC 9126–1:2001. Программная инженерия – Качество продукта

–Часть 1: Модель качества.

4.ГОСТ Р ИСО/МЭК12119–2000. Информационная технология. Пакеты программ. Требования к качеству и тестирование.

5.ГОСТ Р ИСО/МЭК ТО12182-2002 - Информационная технология. Классификация программных средств.

6.ГОСТ Р ИСО/МЭК ТО15271–2002. Информационная технология. Руководство по применению ГОСТ Р ИСО/МЭК12207 (Процессы жизненного цикла программных средств).

7.ГОСТ Р ИСО/МЭК15910–2002. Информационная технология – Процесс создания документации пользователя программного средства.

8.СТБ ИСО/МЭК 12207–2003. Информационная технология. Процессы жизненного цикла программных средств.

9.СТБ ИСО/МЭК 9126–2003. Информационные технологии. Оценка программной продукции. Характеристики качества и руководства по их применению.

10.	Брауде Э. Технология разработки программного обеспечения. –
СПб.: Питер, 2004.
11.	Глухова Л.А., Бахтизин В.В. Основы алгоритмизации и структурного

проектирования программ: Учеб. пособие по курсам «Основы алгоритмизации и программирования» и «Технология разработки программного обеспечения»

для студ. спец. 40 01 01 “Программное обеспечение информационных технологий” дневной формы обучения. – Мн.: БГУИР, 2003.

12. Зиглер К. Методы проектирования программных систем. – М.: Мир,

1985.

13.Йодан Э. Структурное проектирование и конструирование программ.

–М.: Мир, 1979.

14.Калянов Г.Н. CASE-технологии. Консалтинг при автоматизации бизнес-процессов. – М., 2000.

15.Каменнова М.С. Системный подход к проектированию сложных систем // Журнал д-ра Добба. – 1993. - № 1.

16.Кинг Д. Создание эффективного программного обеспечения. – М.:

Мир, 1991.

17. Маклаков С.В BPwin и Erwin. CASE-средства разработки информационных систем. – М., 1999.

177

18.	Марка	Д.А., МакГоуэн	К. Методология структурного анализа и
проектирования SADT. – М., 1993.
19.	Орлов	С.А. Технологии	разработки	программного	обеспечения. –
СПб.: Питер, 2002.
20.	Фатрелл	.Р, Шафер Д.,	Шафер	Л. Управление	программными

проектами: достижение оптимального качества при минимуме затрат. – М.: Вильямс, 2003.

21.Шлеер .,С Меллер . С Объектно-ориентированный анализ: моделирование мира в состояниях. – Киев: Диалектика, 1993.

178