Добавил:
Upload Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:
учебник ППс.doc
Скачиваний:
7
Добавлен:
01.05.2025
Размер:
2.14 Mб
Скачать

Глава 16. Документационное обеспечение ппс

16.1 Проектная документация

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

Эксплуатационная документация включает:

  1. описание применения,

  2. руководство пользователя,

  3. руководство программиста (оператора).

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

В ряде случаев для ПО массового применения, как правило, создаются:

  • автоматизированная контекстно-зависимая помощь (HELP);

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

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

Проектной документацией являются:

  1. техническое задание,

  2. пояснительная записка к эскизному проекту,

  3. документы технического проекта.

Техническое задание оформляется на стадии разработки технического задания. Приводятся общие сведения об объекте автоматизации, назначение, цель создания ПО, требования к системе в целом, к информационному, программному, техническому обеспечению, порядок создания и т.д. В том числе указывается, какая информация вводится в систему, в какой форме, как она должна храниться, какие выходные документы должна система генерировать. Определяются также требования к секретности, уровню защиты информации и многие другие условия, которым система должна удовлетворять. Техническое задание должно содержать:

  1. Полное наименование программы.

  2. Цель и назначение разработки.

  3. Заказчик работы.

  4. Исполнитель и соисполнители проекта.

  5. Сроки исполнения проекта.

  6. Требования, предъявляемые к обучающей программе.

  7. Требования, предъявляемые к аппаратной платформе и операционной системе.

В пояснительной записке отражаются все результаты технических решений. Например, в разделе "Технические характеристики" приводится описание алгоритма и функционирования программы. Пояснительная записка может включать смешанную функциональную модель, совместно со словарем данных, структурные схемы программ, модель данных, модель пользовательского интерфейса.

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

  • комплектность, состав и структуру документации на каждой стадии создания;

  • требования к оформлению документации (включая требования к содержанию разделов, подразделов, пунктов, таблиц и т. д.);

  • правила подготовки, рассмотрения, согласования и утверждения документации с указанием предельных сроков для каждой стадии;

  • требования к настройке издательской системы, используемой в качестве встроенного средства подготовки документации;

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

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

Существуют и специализированные средства разработки проектной документации. Из них наиболее активно используется SoDA ( Software Document Automation ). SoDA позволяет на всех фазах жизненного цикла ПО автоматически извлекать разнообразную информацию, получаемую на разных стадиях разработки проекта, и включать ее в выходные документы. При этом контролируется соответствие документации проекту, взаимосвязь документов, обеспечивается их своевременное обновление. Результирующая документация автоматически формируется из множества источников, число которых не ограничено. Изменения автоматически вносятся только в те части документации, информация для которых была изменена при работе над проектом. Это сокращает время подготовки документации за счет отказа от перегенерации всей документации. SoDA не зависит от применяемых инструментальных средств. Связь с приложениями осуществляется через стандартный программный интерфейс API. Переход на новые инструментальные средства не влечет за собой дополнительных затрат по документированию проекта. SoDA содержит набор шаблонов документов. На их основе можно без специального программирования создавать новые формы документов, определяемые пользователями. Система включает в себя графический редактор для подготовки шаблонов документов. Он позволяет задавать необходимый стиль, фон, шрифт, определять расположение заголовков, резервировать места, где будет размещаться извлекаемая из разнообразных источников информация. Разные виды документации, сопровождающие различные этапы жизненного цикла, связаны между собой, и можно проследить состояние проекта от первоначальных требований до анализа, проектирования, кодирования и тестирования программного продукта. SoDA реализована на базе издательской системы FrameBuilder и предоставляет полный набор средств по редактированию и верстке выпускаемой документации. Итоговым результатом работы системы SoDA является готовый документ (или книга). Документ может храниться в файле формата SoDA ( FrameBuilder ), который получается в результате генерации документа. Вывод на печать этого документа (или его части) возможен из системы SoDA. Среда функционирования SoDA  ОС типа UNIX.