Заключение
Быстрое увеличение сложности и размеров современных комплексов программ при одновременном росте ответственности выполняемых функций резко повысило требования со стороны заказчиков и пользователей к их качеству и безопасности применения. Испытанным средством обеспечения высокой эффективности и качества функционирования программ и программных комплексов являются стандарты документации, разработанные при участии представителей ведущих компаний отрасли.
В России в области обеспечения жизненного цикла и качества сложных комплексов программ в основном применяется группа устаревших ГОСТов, которые отстают от мирового уровня на 5-10 лет.
За последние несколько лет создано множество стандартов ISO, регламентирующих процессы и продукты жизненного цикла программных средств и баз данных, которые могут служить основой для систем обеспечения качества программных продуктов. Необходимо знать и правильно использовать все стандарты документации программных средств для повышения качества продуктов.
Список использованной литературы
В.Э. Карпов «Об оформлении программной документации» (http://www.raai.org/about/persons/karpov/pages/ofdoc/ )
http://www.aanet.ru/~web_k46/textbooks/std_pro/face.htm - Богданов Д.В.,
Путилов В.А., Фильчаков В.В. «Стандартизация процессов обеспечения качества программного обеспечения»
Ю. В. Кагарлицкий «Техническая коммуникация: к постановке проблемы» (http://www.philosoft.ru/techcomm.zhtml)
М. Острогорский «Зачем нужны ГОСТ 19 и ГОСТ 34» (http://www.philosoft.ru/gost34scope.zhtml)
М. Острогорский «Как мир устроен? Концепционный раздел руководства пользователя» (http://www.philosoft.ru/kakmirustroen.zhtml)
Ю. В. Кагарлицкий «Руководство для разработчиков технической документации к программному обеспечению» (http://www.philosoft.ru/_subsites/tcportal/metaguide/)
Приложение А.
Перечень документов еспд
ГОСТ 19.001-77 ЕСПД |
Общие положения. |
ГОСТ 19.101-77 ЕСПД |
Виды программ и программных документов |
ГОСТ 19.102-77 ЕСПД |
Стадии разработки. |
ГОСТ 19.103-77 ЕСПД |
Обозначение программ и программных документов. |
ГОСТ 19.104-78 ЕСПД |
Основные надписи. |
ГОСТ 19.105-78 ЕСПД |
Общие требования к программным документам. |
ГОСТ 19.106-78 ЕСПД |
Требования к программным документам, выполненным печатным способом. |
ГОСТ 19.201-78 ЕСПД |
Техническое задание. Требования к содержанию и оформлению. |
ГОСТ 19.202-78 ЕСПД |
Спецификация. Требования к содержанию и оформлению. |
ГОСТ 19.301-79 ЕСПД |
Порядок и методика испытаний. |
ГОСТ 19.401-78 ЕСПД |
Текст программы. Требования к содержанию и оформлению. |
ГОСТ 19.402-78 ЕСПД |
Описание программы. |
ГОСТ 19.404-79 ЕСПД |
Пояснительная записка. Требования к содержанию и оформлению. |
ГОСТ 19.501-78 ЕСПД |
Формуляр. Требования к содержанию и оформлению. |
ГОСТ 19.502-78 ЕСПД |
Описание применения. Требования к содержанию и оформлению. |
ГОСТ 19.503-79 ЕСПД |
Руководство системного программиста. Требования к содержанию и оформлению. |
ГОСТ 19.504-79 ЕСПД |
Руководство программиста. |
ГОСТ 19.505-79 ЕСПД |
Руководство оператора. |
ГОСТ 19.506-79 ЕСПД |
Описание языка. |
ГОСТ 19.508-79 ЕСПД |
Руководство по техническому обслуживанию. Требования к содержанию и оформлению. |
ГОСТ 19.604-78 ЕСПД |
Правила внесения изменений в программные документы, выполняемые печатным способом. |
ГОСТ 19.701-90 ЕСПД |
Схемы алгоритмов, программ, данных и систем. Условные обозначения и правила выполнения. |
ГОСТ 19.781-90 |
Обеспечение систем обработки информации программное |
Приложение Б.
Эксплуатационная документация на программный продукт
Документ |
Аудитория |
Примерное содержание |
описание программы |
лица, принимающие решения о приобретении, вводе в эксплуатацию и способах использования программы
|
назначение и основные возможности программы, необходимые ей нее системные ресурсы, входные и выходные данные
|
описание применения |
||
описание языка |
пользователи языка (программисты, операторы, кодеры, верстальщики) |
основная идея языка, его синтаксис, элементы и конструкции, встроенные функции |
паспорт |
лица, ответственные за эксплуатацию программы |
краткие сведения о программе и условиях ее поставки |
руководство администратора |
ответственный пользователь системы, обеспечивающий ее целевое применение |
управление учетными записями пользователей, назначение пользователям прав доступа, ведение нормативно-справочной информации, загрузка и выгрузка данных |
руководство оператора |
операторы, работающие с системой, частью которой является программа |
порядок выполнения предусмотренных операций, сообщения программы и предписанные оператору способы реакции на них |
руководство пользователя |
пользователи программы, т.е. лица, применяющие ее для решения собственных прикладных задач |
назначение и возможности программы, ее основные концепции, интерфейс пользователя, порядок решения типовых задач, описание функций программы |
руководство программиста |
программисты, сопровождающие программу или использующие ее в качестве платформы либо средства разработки при создании собственных программ |
архитектура программы или создаваемых на ее основе приложений, описание программных интерфейсов к ее объектам, протоколов обмена данными и т. п. |
руководство системного администратора (системного программиста) |
системные администраторы, осуществляющие установку программы и поддерживающие систему в рабочем состоянии |
установка программы, ее интеграция в систему, проверка правильности функционирования, устранение аварийных ситуаций |
спецификация |
лица, ответственные за эксплуатацию программы |
комплект поставки программы |
справочная система («хелп») |
пользователи, операторы, администраторы, системные администраторы, программисты и др. |
материал всех имеющихся руководств и описаний, краткие описания элементов интерфейса пользователя программы |
формуляр |
лица, ответственные за эксплуатацию программы |
краткие сведения о программе и условиях ее поставки, записи эксплуатационного о возникающих сбоях и прочих событиях такого рода |