Software Documentation Automation
SoDA (Software Documentation Automation), оригинальная разработка компании Rational, су-щественно упрощающая процесс создания проектной документации и поддержания актуальности последней в течение всего цикла разработки ПО.
SoDA (Software Documentation Automation), оригинальная разработка компании Rational, су-щественно упрощающая процесс создания проектной документации и поддержания актуальности последней в течение всего цикла разработки ПО.
SoDA (Software Documentation Automation) – макрос, написанный для MS Word существенно упрощающая процесс создания проектной документации и поддержания актуальности последней в течение всего цикла разработки ПО. SoDA особенно полезна при реализации крупных информационных проектов, в которых на составление документации и ее постоянную переработку часто тратится очень много времени и сил разработчиков.
По задаваемым пользователем шаблонам SoDA "компилирует" документацию, собирая в один документ текстовые и графические данные из различных источников, например из моделей, созданных в Rational Rose. Далее пользователь может отредактировать полученный документ по-средством Microsoft Word или Adobe FrameMaker+SGML. SoDA сама по себе очень зависимый продукт, поскольку, как система отчетности, она базиру-ется на тех данных, которые получает из сторонних программ. SoDA поддерживает всю линейку продуктов Rational Software, позволяя тем самым создавать сложные комбинированные отчеты, базируясь на выходных данных программ состава Rational Suite. Плюс ко всему она имеет доступ к данным из MS Project.
Из основных возможностей следует отметить:
Документирование всех этапов работы над проектом;
Базируясь на шаблонах, IBM Rational SoDA поддерживает возможность стандартиза-ции типов документов в рамках проекта или стандартов компании. IBM Rational SoDA может обеспечить соответствие проектной документации таким международ-ным стандартам, как ISO, SEI CMM, IEEE, а также отечественным серии ГОСТ 19 и 34;
IBM Rational SoDA содержит более 70 шаблонов отчетов;
Для создания шаблонов документов IBM Rational SoDA предлагает простой в ис-пользовании, интуитивно понятный графический язык;
Шаблоны IBM Rational SoDA содержат информацию о формате документа, о его сти-ле и структуре, определяют расположение источника и элементов информации, кото-рые следует извлечь из хранилищ других инструментов IBM Rational;
IBM Rational SoDA использует наиболее популярные средства подготовки докумен-тации – Microsoft Word и Adobe FrameMaker+SGML, что упрощает его освоение;
IBM Rational SoDA может автоматически генерировать документы и отчеты в форма-те HTML, что позволяет создать информационный портал для участников проекта, где можно будет видеть текущее состояние проекта по его документам и отчетам. Подобный подход особенно полезен для объединения географически распределенных групп или групп, работающих на различных платформах;
IBM Rational SoDA осуществляет сбор информации из многочисленных и разнород-ных источников, а также поддерживает русскоязычные шаблоны документов и отче-тов, что позволяет использовать ее для получении практически любых отчетов или документов. Нами разработана методика по которой возможна генерация документов по ГОСТ серии 34 и 19;
Автоматическое извлечение информации из файлов, созданных различными инстру-ментальными средствами. IBM Rational SoDA "понимает", структуру информации, хранимой теми системами, с которыми она интегрирована, а сама информация дос-тупна ей через API этих систем;
Сохранение при "перекомпиляции" текста и графики, введенных пользователем вручную в текстовом процессоре. Если пользователь, скажем, в Microsoft Word, до-бавил какие-нибудь комментарии или иллюстрации в сгенерированный с помощью SoDA документ, то перестраивая данный документ снова, IBM Rational SoDA его не "испортит";
Частичная "перекомпиляция" больших документов. Проектная документация к масштабным программным системам может достигать гигантских объемов. Поэтому в IBM Rational SoDA предусмотрена возможность "перекомпилировать" только те части документации, которые действительно утратили актуальность;
Сбор информации из многочисленных и разнородных источников.