18.3. Пояснение содержания с помощью текста

Текстовые страницы, дополняющие диа­граммы, пишут обычно для того, чтобы изложить основное содержание диаграммы, помочь согла­совать ориентацию читателя с ориентацией авто­ра и описать, как функции самого нижнего уров­ня модели преобразуют свои входы в выходы под влиянием управлений. Текст помогает читателям изучать диаграмму в том порядке, который уменьшает вероятность неправильного понима­ния и уточняет детали системы. Например, на рис. 18-3 текст описывает последовательность действий, выполняемых при подготовке рабочего места. Этот текст находится на уровне детализа­ции, достаточном для рассмотрения его в качес­тве учебного руководства для персонала механи­ческого цеха.

Подготовка хорошего текста требует време­ни, даже если текст относится к одному блоку. Поэтому обычно текст пишется, когда диаграмма перестает подвергаться изменениям. Иногда текст используется для уточнения важных мо­ментов в процессе создания диаграммы. Мы настоятельно рекомендуем по мере возможности использовать графику и цикл автор/читатель, чтобы избавиться от неясностей и построить диа­грамму точно описывающую реальность. После этого вы сможете без труда обобщить или уточ­нить диаграмму при помощи хорошо организо­ванного и насыщенного фактами текста. Напри­мер, если бы мы написали текст сразу после пер­вого наброска диаграммы выполнить задание, представленного на рис. 9-2, нам пришлось бы его несколько раз переписывать, потому что, как показано в части III, диаграмма подверглась су­щественным изменениям в результате рецензи­рования.

Хороший текст должен быть кратким. Нес­колько тщательно подобранных слов могут прояс­нить диаграмму, в то время, как избыточное их количество может совершенно затуманить ее смысл. Обычно все, что нужно для пояснения диаграммы, можно изложить на одной странице текста. Превышение одной страницы снижает качество за счет лишних деталей. Например, текст на рис. 18-3 поясняет, как оператор гото­вит станок и место вокруг него. Обратите внима­ние, что текст не затрагивает дополнительных (например, правил безопасности) и исключи­тельных ситуации (например, отсутствия контей­неров для отходов). При таких обстоятельствах разумнее написать отдельные страницы текста, с пояснением как важных, так и второстепенных вопросов, а также с описанием экстремальных ситуаций и путей выхода из них.

Текст может быть использован для объяс­нения, почему выбрана именно эта декомпозиция или точка зрения, для сообщения о том, как осу­ществляются сложные операции, или для описа­ния допущений, сделанных автором при созда­нии диаграммы. Однако ни при каких обстоя­тельствах текст не должен описывать то, что можно прочесть на диаграмме, уточнять уже декомпозированный блок, идентифицировать ком­поненты декомпозированной дуги, описывать функции блоков или определять названия блоков и дуг (эти названия содержатся на странице глоссария). Следуйте этим рекомендациям и ваши текстовые дополнения будут всегда крат­кими, четкими, информативными и, самое важ­ное, они будут прочитаны.

Рис. 18-3. Подготовка рабочего места