14.6. Резюме

Умение читать диаграммы - один из основ­ных навыков, необходимых участникам SADT-проекта. Первая цель процесса чтения состоит в том, чтобы разобраться в деталях диаграммы. Для этого вначале читают название и номер узла, блоки, внутренние дуги, авторские замечания и дополнительный материал. Вторая цель - понять непосредственный контекст диаграммы. Для это­го изучают декомпозированный блок и его дуги, ICOM-коды, родительскую диаграмму и прило­жение к ней. Это помогает определить место диаграммы в модели. Последняя цель - крити­ческая оценка представленного автором матери­ала. Для этого читатель задает вопросы, связан­ные с использованием синтаксиса, названий бло­ков и дуг, стилем изложения и процессом акти­визации блоков. Все эти шаги предпринимаются читателем для выработки мнения об обоснован­ности и правильности диаграммы.

Дополнительная литература:

Freedman, D., and Weinberg, G/: "Walkthroughs, Inspections, and Technical Reviews", Little Brown, Boston,1982.

MacKay, D.: Information, Mecanism and Meaning, MIT Press, Cambridge, Mass.,1969.

Macnamara, J.: Names of Things, MIT Press, Cambridge, Mass.,1982.

0 Rourke, J.: "Writing for the Reader", DEC, 1976.

SofTech, Inc.: "IDEFO Forms and Procedures Guide", SofTech Deliverable no.7500-11, Septem­ber1979.

Глава 15. Конструктивное комментирова­ние

По мере чтения SADT-диаграмм следует фиксировать возникающие проблемы. В SADTпринят следующий порядок для записи этих проблем, который называется ком­ментированием: (1) сделать запись о продолжи­тельности времени работы, (2) проверить пра­вильность заполнения полей бланка, (3) исполь­зовать по мере необходимости простые обозна­чения согласия или несогласия с автором, (4) использовать поля "Замечания" для записи существенных и конструктивных комментариев, (5) использовать по возможности язык ссылок SADT, (6) еще раз прочитать папку перед воз­вращением ее автору. Теперь мы обсудим техни­ку SADT-комментирования и как сделать ком­ментарии эффективными и конструктивными.

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

15.1. Запись о продолжительности работы

В SADT рекомендуется каждому читателю записывать время, затраченное им на чтение и комментирование папки. Это позволяет вести хронометраж, совершенствовать свои навыки, оценивать сложность папки и получать представ­ление о затратах времени, необходимых для вы­полнения оставшейся работы. Запишите красным цветом время начала и окончания работы над папкой в области специальных инструкций ти­тульного листа. Мы особенно рекомендуем фик­сировать продолжительность работы, если вы только начинаете применять SADT. Делая это, вы заметите стабильное сокращение времени, затрачиваемого вами, новым пользователем SADT, на обработку папки. Потом продолжи­тельность работы будет колебаться в пределах 20 минут в зависимости от сложности папки.