15.5. Язык ссылок sadt

Избыток текста затрудняет чтение диаграм­мы и понимание ее смысла. То же самое справе­дливо и для замечаний. Поэтому в методологии SADT для упрощения замечаний существует язык ссылок. Язык ссылок помогает идентифицировать конкретный блок, дугу или замечание. Код ссыл­ки составляется из номера узла диаграммы или буквенного обозначения страницы папки и ICOM-кода или номера замечаний. ICOM-коды используются для ссылок на определенные дуги конкретного блока. В табл. 15-1 приведены некоторые примеры.

Язык ссылок полезен также при написании текста к диаграмме. Например, описание основ­ного пути потока данных на диаграмме выпол­нить задание, сделанное в разделе 14.2.3 обыч­ным языком, могло бы быть записано с исполь­зованием языка ссылок SADT так: С1 к 1С1 к 102 к 2С1 и ЗС1 и 4С1, и т. д. до тех пор, пока не будет 401 к 112.

Поскольку такие обозначения очень ком­пактны, часто можно видеть, как английский текст на обычном языке сопровождается взятым в скобки выражением на языке ссылок, которое уточняет движение по диаграмме. Мы рекомен­дуем применять язык ссылок после того, как вы и ваша читательская аудитория освоите осталь­ную частью цикла автор/читатель. Однако не исключено, что вы захотите использовать язык ссылок уже в середине работы над вашим пер­вым SADT-проектом.

15.6. Повторное чтение папки

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

показывает, что качество рецензии резко повы­шается, если потратить пару минут на повтор­ный просмотр всей папки

Таблица 15-1. Примеры языка ссылок SADT

Код	Формат	Значение
3	Блок	Блок 3
5	Замечание	Замечание 5
01	Вершина дуги	Граничная дуга
312	Блок+вершина дуг	Вторая входная
	.	дуга блока 3
…	…	Смотри
Е.2	Страница+блок	На стр.Е см. блок 2
A.I	Страница+ замечание	На диаграмме А
		см. замечание 1
А42.3	Диаграмма+блок	На диаграмме А42
		см. блок 3
В.401	Страница+вершина дуги	На стр. В см.
		первую выходную
		дугу блока 4

15.7. Конструктивная критика

Никто не любит, когда его работу крити­куют, не предлагая ничего взамен. SADT настоя­тельно рекомендует позитивный и конструктив­ный стиль комментирования. Конструктивные комментарии коротки, ясны, позитивны и кон­кретны. Например, замечания 4 и 5 на рис. 15-2 не только позволяют исправить ошибку авто­ра, но и поясняют, почему исходная метка дуги неверна.

Особенно важно оказать помощь, если автор допустил серьезный просчет, неправильно понял основную терминологию или построил диаграмму, не отвечающую цели или точке зре­ния модели. В таких случаях мы советуем сде­лать на титульном листе замечание, описываю­щее ситуацию так, как вы ее видите, и предло­жить автору встретиться для обсуждения проб­лемы. В течение последующего диалога автор/ читатель используйте папку в качестве перечня вопросов для встречи и рассмотрите спорные вопросы в порядке номеров замечаний. Папка поможет вам сфокусировать тему беседы и сократить время встречи.

Опытные SADT-читатели не останавливаю­тся в случае, если они не находят ошибок. Их задача тогда отметить все верное. Таким образом можно обнаружить пропуски важных моментов, неуместность отдельных частей диаграммы, не­верную точку зрения или неправильно понятую цель. Вот почему хорошее нужно указывать так же, как плохое. Авторы должны знать, что они на верном пути, даже если есть недочеты. Напри­мер, на рис. 15-2 в замечании к дугеоборудован­ное рабочее местосодержится похвала автору за верное понимание предмета рассмотрения и выразительное название.

Квалифицированные SADT-читатели вклады­вают максимально возможное в свои коммента­рии. Лучше всего для комментариев использовать графический язык SADT. С его помощью читатель может быстро исправить синтаксис, предложить другие метки, направить дуги к другим блокам и рекомендовать другие декомпозиции. Используйте графику всегда, когда это возможно, потому что "меньше слов" часто означает "больше информа­ции". На рис. 16-3 приведен пример графичес­кого замечания.