16.4. Переделка диаграмм

Принято или непринято какое-либо заме­чания читателя отметьте в вашем экземпляре папки. После этого вы готовы к переделке рас­сматриваемой диаграммы и всех других диа­грамм, которые были затронуты. При серьезных изменениях мы рекомендуем начертить диаграм­му заново. На рис. 16-4 показан результат пере­черчивания в соответствии с примечаниями к диаграмме выполнить задание,приведенными на рис. 16-3. Обратите внимание, что замечание 7

Рис. 16-3. Диаграмма с комментариями

Рис. 16-4. Перерисованная диаграмма

заставило автора ввести обратную связь по уп­равлению от блока 4 к блоку 1 и что автор поме­нял ее метку при переделке диаграммы.

Если вы чертите диаграмму заново, не за­будьте отметить заменяемую диаграмму, указав ее С-номер в скобках сразу же после С-номера новой диаграммы, как показано на рис. 16-4. Обратите внимание, что С-номер исходной диа­граммы (DAM010)заключен в скобки и поме­щен рядом с С-номером переделанной диаграм­мы (DAM015).Таким образом с помощью набо­ра указателей, направленных назад, метод SADT связывает между собой различные версии одной и той же диаграммы, чтобы всегда можно было проследить изменения в ходе аналитического проекта.

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

16.5. Резюме

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

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

Elbow, P.: Writing with Power, Oxford University Press, Oxford, England,1982.

Lannon, J.: Technical Writing, Little, Brown, Boston,1982.

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

Minsky, M.: "Form and Content in Computer Science", CACM, vol.17, no.2, April1970.

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

Freedman, D., and Weinberg, G.: "Reviews, Walkthroughs, and Inspections", IEEE Transactions on Software Engineering, vol.10, no.1, January 1984.

Weinberg, G.: Rethinking Systems Analysis and Design, Little Brown, Boston,1982.

Weinberg, G.: Understanding the Professional Programmer, Little Brown, Boston,1982.

Weizenbaum, J.: Computer Power and Human Rreason, W.H. Freeman,1976.