Смекни!
smekni.com

Документирование программного обеспечения (стр. 3 из 3)

Описание архитектуры программного средства (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.