Для создания документации в процессе разработки ИС
используются разнообразные средства формирования отчетов, а
также компоненты издательских систем. Обычно средства
документирования встроены в конкретные CASE-средства.
Исключением являются некоторые пакеты, предоставляющие
дополнительный сервис при документировании. Из них наиболее
активно используется SoDA (Software Document Аutomation).
Продукт SoDA предназначен для
автоматизации разработки
проектной документации на всех
фазах ЖЦ ПО. Он позволяет
автоматически извлекать
разнообразную информацию,
получаемую на разных стадиях
разработки проекта, и включать ее в
выходные документы. При этом
контролируется соответствие
документации проекту, взаимосвязь
документов, обеспечивается их
своевременное обновление.
Результирующая документация
автоматически формируется из
множества источников, число
которых не ограничено.
SoDA не зависит от применяемых
инструментальных средств. Связь с
приложениями осуществляется через
стандартный программный интерфейс
API. Переход на новые
инструментальные средства не
влечет за собой дополнительных
затрат по документированию
проекта.
SoDA содержит набор шаблонов
документов, определяемых
стандартом на программное
обеспечение DOD 2167A. На их основе
можно без специального
программирования создавать новые
формы документов, определяемые
пользователями.
Пакет включает в себя графический
редактор для подготовки шаблонов
документов. Он позволяет задавать
необходимый стиль, фон, шрифт,
определять расположение
заголовков, резервировать места,
где будет размещаться извлекаемая
из разнообразных источников
информация. Изменения
автоматически вносятся только в те
части документации, на которые они
повлияли в программе. Это сокращает
время подготовки документации за
счет отказа от перегенерации всей
документации.
SoDA реализована на базе
издательской системы FrameBuilder и
предоставляет полный набор средств
по редактированию и верстке
выпускаемой документации. Разные
версии документации могут быть для
наглядности отмечены своими
отличительными признаками. В
системе создаются таблицы
требований к проекту, по которым
можно проследить, как реализуются
эти требования. Разные виды
документации, сопровождающие
различные этапы ЖЦ, связаны между
собой, и можно проследить состояние
проекта от первоначальных
требований до анализа,
проектирования, кодирования и
тестирования программного
продукта.
Итоговым результатом работы
системы SoDA является готовый
документ (или книга). Документ может
храниться в файле формата SoDA (Frame
Builder), который получается в
результате генерации документа.
Вывод на печать этого документа
(или его части) возможен из системы
SoDA.
Среда функционирования SoDA - ОС
типа UNIX на рабочих станциях Sun
SPARCstation, IBM RISC System/6000 или Hewlett Packard HP 9000
700/800.
SoDA требует по крайней мере 32 MB
оперативной памяти, 100-300 MB для
установки и 64 MB рабочего
пространства на диске.
