
- •ТЕХНОЛОГИЯ РАЗРАБОТКИ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ
- •Документирование программного обеспечения
- •Документирование программного обеспечения Цели изучения и рассматриваемые вопросы
- •Документирование программного обеспечения Определения
- •Документирование программного обеспечения Определения
- •Документирование программного обеспечения Определения
- •Документирование программного обеспечения Зачем ?
- •Документирование. Зачем ? Для управления разработкой.
- •Документирование. Зачем ?
- •Документирование. Зачем ? Для обеспечения эксплуатации.
- •Документирование. Зачем ?
- •Документирование. Зачем ? Для обеспечения качества.
- •Документирование. Зачем ? Исторические справки.
- •Документирование программного обеспечения Стратегия документирования
- •Документирование программного обеспечения Категории (типы) документов
- •Категории документов Документация разработки
- •Документация разработки Типовые документы разработки
- •Категории документов Документация продукции
- •Документация продукции Типовые документы продукции
- •Документация управления проектом Типовые документы управления проектом
- •Документирование программного обеспечения Стандарты документирования
- •Документирование программного обеспечения Стандарты документирования. Зачем и что?
- •Единая система программной документации (ЕСПД). Назначение.
- •Единая система программной документации (ЕСПД). Область распространения и состав.
- •ЕСПД.
- •ЕСПД.
- •ЕСПД.
- •ГОСТ 19.101-77 ЕСПД.
- •ГОСТ 19.101-77 ЕСПД.
- •ЕСПД.
- •ЕСПД.
- •ГОСТ 19.701-90 ЕСПД.
- •ГОСТ 19.105-78 ЕСПД.
- •ГОСТ 19.106-78 ЕСПД. Требования к программным документам, выполненным печатным способом.
- •ГОСТ Р ИСО/МЭК
- •ГОСТ Р ИСО/МЭК 12207-99. Информационная технология. Процессы жизненного цикла программных средств. (1)
- •ГОСТ Р ИСО/МЭК 12207-99. Информационная технология. Процессы жизненного цикла программных средств. (2)
- •ГОСТ Р ИСО/МЭК 12207-99. Информационная технология. Процессы жизненного цикла программных средств. (3)
- •ГОСТ Р ИСО/МЭК 12207-99. Информационная технология. Процессы жизненного цикла программных средств. (4)
- •ГОСТ Р ИСО/МЭК ТО 9294-93 ИТ. Руководство по управлению документированием ПО
- •ГОСТ Р ИСО 9127-94 Системы обработки информации. Документация пользователя и информация на упаковке
- •ГОСТ Р ИСО 9127-94 Системы обработки информации. Документация пользователя и информация на упаковке

ЕСПД.
Документы учетного характера.
Есть также группа стандартов, определяющая требования к фиксации всего набора программ и ПД, которые оформляются для передачи ПС. Они порождают лаконичные документы учетного характера и могут быть полезны для упорядочения всего хозяйства программ и ПД (ведь очень часто требуется просто навести элементарный порядок!). Есть и стандарты, определяющие правила ведения документов в "хозяйстве" ПС.
ГОСТ 19.501-78 ЕСПД. Формуляр. Требования к содержанию и оформлению.
ГОСТ 19.604-78 ЕСПД. Правила внесения изменений в программные документы, выполняемые печатным способом.
ГОСТ 19.202-78 ЕСПД. Спецификация. Требования к содержанию и оформлению.
© 2005, В.В.Хашковский, Д.П.Калачев. |
31 |

ГОСТ 19.701-90 ЕСПД.
Схемы алгоритмов, программ, данных и систем.
Устанавливает правила выполнения схем, используемых для отображения различных видов задач обработки данных и средств их решения:
Схема данных: отображает путь данных при решении задач, определяет
этапы обработки, определяет применяемые носители данных.
Схема программ: отображает последовательность операций в программе (указывает фактические этапы обработки данных; определяет путь в зависимости от логических условий). Состоит из символов процесса.
Схема работы системы: отражает управление операциями и потоком
данных системы. Состоит из: символов процесса, указывающих операций, которые необходимо выполнять над данными, а так же определяющих путь их выполнения; линейных символов, указывающих потоки данных между процессами или носителями данных, а также указывающих поток управления между процессами; специальных символов, используемых для облегчения чтения процесса.
Схема взаимодействия программ: отображает путь активаций программ и взаимодействий программ с данными.
Схема ресурсов системы: отображает конфигурацию блоков данных и обрабатывающих блоков, которые требуются для решения задач или набора задач.
© 2005, В.В.Хашковский, Д.П.Калачев. |
32 |

ГОСТ 19.105-78 ЕСПД.
Общие требования к программным документам
Стандарт устанавливает общие требования к оформлению программных документов, предусмотренных стандартами Единой системы программной документации (ЕСПД) для любого способа выполнения документов на различных носителях данных.
Программный документ может быть представлен на различных типах носителей данных и состоит из следующих условных частей:
титульной;
информационной;
основной.
Правила оформления документа и его частей на каждом носителе данных устанавливаются стандартами ЕСПД на правила оформления документов на соответствующих носителях данных.
В дополнение к нему:
ГОСТ 19.104-78 ЕСПД. Основные надписи.
ГОСТ 19.106-78 ЕСПД. Требования к программным документам, выполненным печатным способом.
ГОСТ 28388-89 Системы обработки информации. Документы на магнитных носителях данных. Порядок выполнения и обращения.
© 2005, В.В.Хашковский, Д.П.Калачев. |
33 |

ГОСТ 19.106-78 ЕСПД. Требования к программным документам, выполненным печатным способом.
Расположение материалов программного документа осуществляется в следующей последовательности:
титульная часть:
лист утверждения (не входит в общее количество листов документа);
титульный лист (первый лист документа);
информационная часть:
аннотация;
лист содержания;
основная часть:
текст документа (с рисунками, таблицами и т.п.)
перечень терминов и их определений;
перечень сокращений;
приложения;
предметный указатель;
перечень ссылочных документов;
часть регистрации изменений:
лист регистрации изменений.
© 2005, В.В.Хашковский, Д.П.Калачев. |
34 |

ГОСТ Р ИСО/МЭК
ГОСТ Р ИСО/МЭК 12207-99. Информационная технология. Процессы жизненного цикла программных средств. Настоящий стандарт устанавливает, используя четко определенную терминологию, общую структуру процессов жизненного цикла программных средств, на которую можно ориентироваться в программной индустрии.
ГОСТ Р ИСО/МЭК ТО 9294-93 ИТ. Руководство по управлению документированием ПО является одним из основных стандартов в данной области и представляет собой руководство по документированию ПО для тех
руководителей, которые отвечают за разработку программного обеспечения.
Данное руководство предназначено для помощи руководителям в обеспечении эффективного проведения документирования в организациях. Данный стандарт направлен на определение стратегий, стандартов, процедур, ресурсов и планов, которыми должны заниматься сами руководители для того, чтобы эффективно управлять документированием ПО.
ГОСТ Р ИСО 9127-94 Системы обработки информации. Документация пользователя и информация на упаковке для потребительских пакетов
вводит определение документации пользователя, как документации, которая обеспечивает пользователей информацией, необходимой для установки и прогона ПО и является обязательной в поставке (документация пользователя выполняется в виде одного или нескольких руководств и вкладывается вместе с программным продуктом внутрь упаковки).
© 2005, В.В.Хашковский, Д.П.Калачев. |
35 |

ГОСТ Р ИСО/МЭК 12207-99. Информационная технология. Процессы жизненного цикла программных средств. (1)
Цель – описание организации процесса документирования.
Процесс документирования является процессом формализованного
описания информации, созданной в процессе или работе жизненного цикла. Данный процесс состоит из набора работ, при помощи которых планируют,
проектируют, разрабатывают, выпускают, редактируют, распространяют и сопровождают те документы, в которых нуждаются все заинтересованные лица, такие как администраторы, инженеры и пользователи системы или программного продукта.
Список работ:
1.подготовка процесса;
2.проектирование и разработка;
3.выпуск;
4.сопровождение.
© 2005, В.В.Хашковский, Д.П.Калачев. |
36 |

ГОСТ Р ИСО/МЭК 12207-99. Информационная технология. Процессы жизненного цикла программных средств. (2)
6.1.1 Подготовка процесса
Данная работа состоит из следующих задач:
6.1.1.1 Должен быть разработан, документально оформлен и реализован план обозначения документов, выпускаемых в процессах жизненного цикла программного продукта. Для каждого обозначаемого документа должны быть определены:
a)заголовок или наименование;
b)назначение;
c)пользователи документа;
d)процедуры и обязанности по подготовке исходных материалов, разработке, проверке, изменению, утверждению, выпуску, хранению, распространению, сопровождению и управлению конфигурацией;
e)сроки выпуска промежуточных и окончательных редакций.
© 2005, В.В.Хашковский, Д.П.Калачев. |
37 |

ГОСТ Р ИСО/МЭК 12207-99. Информационная технология. Процессы жизненного цикла программных средств. (3)
6.1.2 Проектирование и разработка
Данная работа состоит из следующих задач:
6.1.2.1 Каждый конкретный документ должен быть спроектирован в
соответствии с используемыми стандартами на документацию в части: формата; состава и содержания разделов; нумерации страниц; расположения и оформления рисунков и таблиц; отметок об авторских правах, правах доступа; брошюровки и других элементов представления информации.
6.1.2.2 Должны быть подтверждены источник и соответствие исходных материалов для документов. При подготовке документов могут использоваться средства автоматизации документирования.
6.1.2.3 Подготовленные документы должны быть проверены и отредактированы в части форматов, технического содержания и стиля
представления в соответствии с используемыми стандартами на документацию. Документы перед выпуском должны быть утверждены (согласованы) компетентными лицами.
© 2005, В.В.Хашковский, Д.П.Калачев. |
38 |

ГОСТ Р ИСО/МЭК 12207-99. Информационная технология. Процессы жизненного цикла программных средств. (4)
6.1.З Выпуск
Данная работа состоит из следующих задач:
6.1.3.1 Документы должны быть изданы и распространены в соответствии с планом. При издании и распространении документов могут использоваться бумажные, электронные или другие носители. Оригиналы документов должны храниться в соответствии с требованиями по учету, хранению, защите, обращению и дублированию.
6.1.3.2 Средства управления документированием должны быть определены в соответствии с процессом управления конфигурацией (подраздел 6.2).
6.1.4 Сопровождение
Данная работа состоит из следующей задачи:
6.1.4.1 Должны быть решены задачи, связанные с внесением изменений в документацию (подраздел 5.5). Изменения в документы, находящиеся под управлением конфигурацией, вносят в соответствии с процессом управления конфигурацией (подраздел 6.2).
© 2005, В.В.Хашковский, Д.П.Калачев. |
39 |

ГОСТ Р ИСО/МЭК ТО 9294-93 ИТ. Руководство по управлению документированием ПО
…
© 2005, В.В.Хашковский, Д.П.Калачев. |
40 |