Практическая работа № 2.23. Оформление документации на программные

114 
Общие требования к составу и содержанию документов, поддерживающих создание 
программных средств, представлены в ряде стандартов разного ранга. Состав документов 
широко варьируется в зависимости от класса и характеристик объекта разработки. 
Существует несколько стандартов в области обеспечения документирования 
программных средств. 
ISO 12207 - Информационные технологии. Процессы жизненного цикла программного 
обеспечения. 
В этом стандарте документированию посвящен специальный раздел в группе 
вспомогательных процессов. 
ISO 9000- 3 - Общее руководство качеством и стандарты по обеспечению качества. 
Управлению качеством документации посвящен специальный раздел 6.2. Эти задачи 
отражены также в ряде разделов стандарта, непосредственно регламентирующих управление 
качеством сложных программных средств. 
ISO 6592 – Обработка информации. Руководство по разработке документации для 
вычислительных систем 
Главная цель этого стандарта состоит в установлении базисной структуры 
документации, на основе которой возможно для любого проекта обеспечить эффективное 
совершенствование и реализацию информационной системы, ПС или БД. В стандарте 
установлены руководящие принципы создания документов для информационных систем. 
ISO 9294 - Информационные технологии. Руководящие положения по управлению 
документацией на программное обеспечение 
Технический отчет этого стандарта представляет руководство по документированию ПС 
для руководителей, отвечающих за создание программной продукции. Руководство 
предназначено для помощи в управлении разработкой и эффективном документировании 
программных проектов. 
IEEE 1063-1993 - Пользовательская документация на программное обеспечение. 
+В нем представлены наиболее полно общие требования к пользовательской 
документации на программные средства широкого применения. Стандарт определяет 
минимальные требования к структуре и содержанию комплекта документов для 
пользователей программных продуктов. 
ГОСТ 34.602—89 Информационная 
технология. 
Комплекс 
стандартов 
на 
автоматизированные системы. Техническое задание на создание автоматизированной системы 
Настоящий стандарт распространяется на автоматизированные системы для 
автоматизации различных видов деятельности (управление, проектирование, исследование и 
т. п.), включая их сочетания, и устанавливает состав, содержание, правила оформления 
документа “Техническое задание на создание (развитие или модернизацию) системы”. 
ГОСТ Р 51904-2002 — Программное обеспечение встроенных систем. Общие 
требования к разработке и документированию. 
Стандарт распространяется на процессы разработки и документирования программного 
обеспечения встроенных систем реального времени. Стандарт распространяется на все 
действия, имеющие отношение к разработке программного обеспечения. 
ГОСТ 19.101 – Виды программ и программных документов. 
Настоящий стандарт устанавливает виды программ и программных документов для 
вычислительных машин, комплексов и систем независимо от их назначения и области 
применения. Виды программных документов и их содержание приведены в таблице 1: 
Таблица 19
Вид 
программного 
документа 
Содержание программного документа 
1 
2 
Спецификация 
Состав программы и документации на нее 

115 
Ведомость держателей 
подлинников 
Перечень предприятий, на которых хранят подлинники 
программных документов 
Текст программы 
Запись программы с необходимыми комментариями 
Описание программы 
Сведения о логической структуре и функционировании 
программы 
Программа и методика 
испытаний 
Требования, подлежащие проверке при испытании 
программы, а также порядок и методы их контроля 
Техническое задание 
Назначение и область применения программы, 
технические, технико-экономические и специальные 
требования, предъявляемые к программе, необходимые 
стадии и сроки разработки, виды испытаний 
Пояснительная записка 
Схема алгоритма, общее описание алгоритма и (или) 
функционирования программы, а также обоснование 
принятых технических и технико-экономических 
решений 
Эксплуатационные 
документы 
Сведения для обеспечения функционирования и 
эксплуатации программы 
Порядок выполнения работы:
Оформить пояснительную записку (ПЗ) на программный продукт. 
ПЗ на программное средство должна иметь следующую структуру: 
1) Постановка задачи; 
2) Входные и выходные данные; 
3) Среда разработки и обоснование выбора языка программирования; 
4) Описание алгоритма; 
5) Описание используемых классов и методов; 
6) Заключение. 
Приложение A – Техническое задание; 
Приложение Б – Технический проект; 
Приложение В – Иерархия функциональных диаграмм. Диаграмма сущность-связь. 
Диаграмма потоков данных 
Приложение Г UML-диаграммы 
Приложение Д Листинг программы 
Содержание отчета: ПЗ на электронном и бумажном носителе. 

жүктеу/скачать 2,59 Mb.

Достарыңызбен бөлісу: