
- •Часть III. Рецензирование диаграмм и моделей
- •Глава 12. Цикл автор/читатель
- •12.1. Составление исходной документации
- •12.3. Ответы на комментарии
- •12.4. Совершенствование моделей
- •12.5. Цикл автор/читатель
- •12.6. Резюме
- •Глава 13. Подготовка папки
- •13.1. Обмен информацией с помощью папок
- •13.2. Титульный лист
- •13.3. Организация папки
- •13.4. Размеры папки
- •13.5. Когда формировать папку
- •13.6. Резюме
- •Глава 14. Чтение диаграмм и моделей
- •14.1. Процедура чтения
- •14.2. Изучение деталей диаграммы
- •14.4. Уточнение места диаграммы в модели
- •14.5. Критическая оценка содержания диаграммы
- •14.6. Резюме
- •Глава 15. Конструктивное комментирование
- •15.1. Запись о продолжительности работы
- •15.2. Проверка заполнения полей бланка диаграммы
- •15.3. Обозначения согласия и несогласия с автором
- •15.4. Замечания
- •15.5. Язык ссылок sadt
- •15.6. Повторное чтение папки
- •15.7. Конструктивная критика
- •15.8. Резюме
- •Глава 16. Ответы на комментарии и их обобщение
- •16.1. Чтение и ответы на замечания
- •16.2. Беседа автор/читатель
- •16.3. Обобщение читательских комментариев
- •16.4. Переделка диаграмм
- •16.5. Резюме
- •Часть IV. Завершение моделирования. Руководство моделированием
- •Глава 17. Завершение моделирования
- •17.1. Размер sadt-моделей
- •17.2. Прекращение декомпозиции
- •17.3. Достаточная детализированность
- •17.4. Изменение уровня абстракции
- •17.5. Изменение точки зрения
- •17.6. Сходные функции
- •17.7. Тривиальные функции
- •17.8. Принятие решения о завершении моделирования
- •17.9. Резюме
- •Глава 18. Дополнения к диаграммам и моделям
- •18.1. Дополнения к диаграммам
- •18.2. Определение терминологии с помощью глоссария
- •18.3. Пояснение содержания с помощью текста
- •18.4. Пояснение с помощью рисунков
- •18.5. Дополнение моделей
- •Глава 19. Примечания на диаграммах и моделях
- •19.1. Информация о свойствах
- •19.2. Правила действия
- •19.3. Генерация правил действия
- •19.4. Резюме
- •Глава 20. Управление проектом
- •20.1. Начало проекта
- •20.2. Создание и рецензирование результатов работы
- •20.3. Создание модели
- •20.5. Резюме
- •Глава 21. Средства автоматизации
- •21.4. Сводный список для оценки автоматизированной поддержки sadt
- •21.5. Резюме
13.4. Размеры папки
SADT-папка не всегда формируется для каждой новой диаграммы. Размеры папок могут быть различными и зависят как от проекта, так и от работающих над ним. Сложность изучаемой системы, доступность экспертов и опытность аналитиков также влияют на объем информации, включаемой в папку. Однако для большинства SADT-проектов типичным является рабочая папка, включающая контекстную диаграмму, основную диаграмму и лист глоссария. Мы рекомендуем составлять папки именно такого размера во всех случаях, когда вы сомневаетесь в объеме информации, приемлемом для читателей.
Рис. 13-3. Заполненный титульный SADT-папки
Рис. 13-4. Подготовка страницы глоссария
Одна диаграмма, декомпозиция хотя бы одного из ее блоков и, возможно, лист глоссария или иллюстрация представляют собой оптимальный размер папки. Мы рекомендуем такой объем в качестве стандарта, чтобы вы никогда не включали в папку для рецензирования слишком много информации. Наш опыт показывает, что, независимо от обстоятельств, папка не должна содержать более одной диаграммы и ее прямых потомков - в общей сложности не более шести диаграмм. Если в папку включен дополнительный материал, количество диаграмм следует уменьшить. Папка с более чем 6 страницами информации может перегрузить ваших читателей, и вы получите очень слабый отклик. Поэтому лучше ошибиться в сторону уменьшения объема информации, чем предъявлять завышенные требования к читательской аудитории. Если большие папки станут для вас нормой, вы можете через некоторое время столкнуться с падением активности читательской аудитории. Единственным исключением является публикация всей модели в виде папки в конце аналитического проекта. Читатели готовы к тому, что такие папки должны быть объемны, но в то же время они знают, что их будет очень немного.
13.5. Когда формировать папку
Момент для формирования папки в процессе проектирования выбирается отнюдь не случайно. Вообще говоря, папка составляется, если автор чувствует, что появилось достаточно новой информации, чтобы отправить ее на рецензирование. Однако это не единственный повод для формирования папки. Папку также следует составлять, когда автору не хватает информации для продолжения работы или он сомневается в верности сделанного. В этих случаях мы рекомендуем послать папку небольшому числу вполне определенных специалистов, которые могут вам помочь. Например, пошлите незаконченные рабочие материалы самым опытным экспертам или самым опытным SADT-авторам, чьи знания помогут вам. Получив от них замечания, вы сможете, как правило, довести свою работу до степени, необходимой для рассылки папок всей вашей читательской аудитории для получения новых замечаний.
13.6. Резюме
SADT-папка представляет собой небольшой набор взаимосвязанных SADT-диаграмм и других материалов, отобранных автором для рецензирования читательской аудиторией. Папки составляются, как только автор почувствует, что накопилось достаточно новой информации для рецензирования. Размеры папок должны быть небольшими, чтобы обеспечить быстрое рецензирование. Титульный лист папки содержит название папки, ее краткое содержание и фамилии экспертов, которые должны прочитать папку.
Дополнительная литература
Connor, M.: "Structured Analysis and Design Technique - SADT", Auerbach portfolio 32-04-02, 1979.
King, L: "Guidelines for an SADT Chief Author", SofTech Deliverable no. 9595-2, 1980.
Ross, D. and Schoman, K.: "Structured Analysis for Requirements Definitions", IEEE Transactions on Software Engineering, vol. SE-3, no. 1, January 1977.