Документирование программного обеспечения

Страница: 5/5

1. документация, определяющая строение программ и структур данных ПС и технологию их разработки;

2. документацию, помогающую вносить изменения в программное средство.

Документация первой группы содержит итоговые документы каждого технологического этапа разработки программного средства. Она включает следующие документы:

Внешнее описание программного средства (Requirements document).

Описание архитектуры программного средства (description of the system architecture), включая внешнюю спецификацию каждой ее программы.

Для каждой программы программного средства - описание ее модульной структуры, включая внешнюю спецификацию каждого включенного в нее модуля.

Для каждого модуля - его спецификация и описание его строения (design description).

Тексты модулей на выбранном языке программирования (program source code listings).

Документы установления достоверности программного средства (validation documents), описывающие, как устанавливалась достоверность каждой программы программного средства и как информация об установлении достоверности связывалась с требованиями к программному средству.

Документы установления достоверности включают прежде всего документацию по тестированию (схема тестирования и описание комплекта тестов), но могут включать и результаты других видов проверки программного средства, например, доказательства свойств программ.

Документация второй группы содержит

Руководство по сопровождению программного средства (system maintenance guide), которое описывает известные проблемы вместе с программным средством, описывает, какие части системы являются аппаратно- и программно-зависимыми, и как развитие программного средства принято в расчет в его строении (конструкции).

Общая проблема сопровождения программного средства - обеспечить, чтобы все его представления шли в ногу (оставались согласованными), когда программное средство изменяется. Чтобы этому помочь, связи и зависимости между документами и их частями должны быть зафиксированы в базе данных управления конфигурацией.

Вид эксплуатационного документа

Содержание эксплуатационного документа

Ведомость эксплуатационных документов

Перечень эксплуатационных документов на программу.

Формуляр

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

Описание применения

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

Руководство системного программиста

Сведения для проверки, обеспечения функционирования и настройки программы на условия конкретного применения.

Руководство программиста

Сведения для эксплуатации программы.

Руководство оператора

Сведения, необходимые для осуществления действий, связанных с выполнением программы вычислительной системой.

Описание языка

Описание синтаксиса и семантики языка.

Руководство по техническому обслуживанию

Сведения для применения текстовых и диагностических программ при обслуживание технических средств.

1. http://www.ergeal.ru/archive/cs/tp/ - Технология программирования, конспект лекций ВМиК МГУ, кафедра системного программирования

2.http://www.aanet.ru/~web_k46/textbooks/std_pro/face.htm - Богданов Д.В., Путилов В.А., Фильчаков В.В. Стандартизация процессов обеспечения качества программного обеспечения. - Апатиты, КФ ПетрГУ, 1997.

Реферат опубликован: 29/04/2007