13.3. Организация папки
SADT-папка состоит из титульного листа, одной или более диаграмм и, возможно, дополнительного материала. Титульный лист содержит название и краткое содержание рабочих материалов и служит для сопровождения папки в цикле общения автора с читателями. Диаграммы располагаются после титульного листа в порядке возрастания номеров узлов. Листы иллюстраций и глоссария, которые дополняют диаграммы, располагаются сразу же после тех диаграмм, к которым они относятся (дополнения к диаграммам подробно рассматриваются в главе 18).
На рис. 13-3 показана SADT-папка, содержащая результаты анализа, проведенного в части I, где обсуждались начало разработки и частичная декомпозиция модели экспериментального механического цеха. На титульном листе указано, что эта папка относится к декомпозиции объекта выполнить задание, на диаграмме ЭМЦ/А2. Кроме того, на титульном листе помещено замечание автора, в котором он просит объяснить понятие деталь. Диаграмма ЭМЦ/АО изготовить нестандартную деталь расположена перед диаграммой выполнить задание для того, чтобы обеспечить читателей контекстом. Лист глоссария ЭМЦ/А2Г1 определяет терминологию, введенную на диаграмме выполнить задание. Он расположен после диаграммы.
3.4. Размеры папки
SADT-папка не всегда формируется для каждой новой диаграммы. Размеры папок могут быть различными и зависят как от проекта, так и от работающих над ним. Сложность изучаемой системы, доступность экспертов и опытность аналитиков также влияют на объем информации, включаемой в папку. Однако для большинства SADT-проектов типичным является рабочая папка, включающая контекстную диаграмму, основную диаграмму и лист глоссария. Мы рекомендуем составлять папки именно такого размера во всех случаях, когда вы сомневаетесь в объеме информации, приемлемом для читателей. Одна диаграмма, декомпозиция хотя бы одного из ее блоков и, возможно, лист глоссария или иллюстрация представляют собой оптимальный размер папки (более подробное рассмотрение факторов, влияющих на размеры папки, см. в главе 20), Мы рекомендуем такой объем в качестве стандарта, чтобы вы никогда не включали в папку для рецензирования слишком много информации. Наш опыт показывает, что, независимо от обстоятельств, папка не должна содержать более одной диаграммы и ее прямых потомков — в общей сложности не более шести диаграмм. Если в папку включен дополнительный материал, количество диаграмм следует уменьшить. Папка с более чем 6 страницами информации может перегрузить ваших читателей, и вы получите очень слабый отклик. Поэтому лучше ошибиться в сторону уменьшения объема информации, чем предъявлять завышенные требования к читательской аудитории. Если большие папки станут для вас нормой, вы можете через некоторое время столкнуться с падением активности читательской аудитории. Единственным исключением является публикация всей модели в виде папки в конце аналитического проекта. Читатели готовы к тому, что такие папки должны быть объемны, но в то же время они знают, что их будет очень немного.
Рис. 13-3. Заполненный титульный SADT-папки
Рис. 13-4. Подготовка страницы глоссария