Текст дополнения

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

• изложить основное содержание диаграммы;

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

• сообщить о том, как осуществляются сложные операции;

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

• помочь согласовать ориентацию эксперта с ориентацией автора;

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

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

• уточнить детали системы.

Т.к. подготовка хорошего текста требует времени, то описание создается, когда диаграмма перестает подвергаться изменениям. Обобщать/уточнять диаграмму при помощи хорошо организованного и насыщенного фактами текста становится легче после произведенного гра-фического описания.
Текст не должен:

• описывать то, что можно прочесть на диаграмме;

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

• идентифицировать компоненты декомпозированной дуги;

• описывать функции блоков или определять названия блоков и дуг (эти названия содержатся на странице глоссария);

• быть большого объема (более одной страницы). Несколько тщательно подобранных слов могут прояснить диаграмму, в то время, как избыточное их количество может привести к ис-каженному восприятию ее смысла.

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