Глава 16. Ответы на комментарии и их обобщение
- 16.1. Чтение и ответы на замечания
- 16.2. Беседа автор/читатель
- 16.3. Обобщение читательских комментариев
- 16.4. Переделка диаграмм
- 16.5. Резюме
Процесс ответов на комментарии читателей называется реагированием. В этом процессе автор участвует после получения от библиотекаря папки с комментариями. В SADT упорядоченный процесс реагирования обеспечивает высокий уровень согласованности и компетентности для обратной связи автора с читательской аудиторией. Чтобы отреагировать на откомментированную папку, автор: (1) изучает каждое замечание читателя и отвечает на него; (2) принимает решение о необходимости диалога автор/читатель для обсуждения основных вопросов; (3) обобщает все комментарии на авторской копии папки; (4) переделывает диаграмму в соответствии с набором обобщенных замечаний.
Прежде чем перейти к обсуждению основной темы данной главы, следует отметить один важный момент. В SADT ответы автора рассматриваются как самостоятельные понятия, отличные как от диаграммы, так и от читательских замечаний. Они не становятся частью диаграммы. Ответы автора как бы накладываются на откомментированную диаграмму. (Представьте себе, что ответы как бы пишутся на прозрачном куске пластика, помещаемом поверх диаграммы.) В SADT используется для ответов синий цвет, чтобы они отличались как от самой диаграммы, так и от читательских замечаний. (В книге на всех рисунках вместо синего цвета используется темно-серый.) На рис. 16-1 и 16-2 приведен пример папки с ответами.
16.1. Чтение и ответы на замечания
Вначале бегло просмотрите папку, отмечая замечания и фиксируя их количество. Вы получите представление о тех частях папки, которые в общем не вызывают сомнения, и о тех, к которым много претензий. Кроме того, посмотрите, сколько времени затратил читатель. Это позволит вам оценить, насколько трудно было комментировать папку. Продолжительность своей работы тоже отметьте на титульном листе. Просмотрев все замечания, вернитесь назад и ответьте на каждое из них. Старайтесь понять, что хотел сказать читатель. Сделайте вывод. Если вы согласны, поставьте галочку, если нет, поставьте крестик. Например, на диаграмме ЭМЦ/А2 (рис. 16-2) автор обозначил согласие с замечаниями 1-5 и несогласие - с замечанием 6.
Сделав пометку около замечания, добавьте, если нужно, пояснительный текст. Ответьте на вопрос читателя, объясните смысл или поясните, почему вы не согласны с его комментарием. Например, объяснение автора по поводу его несогласия с замечанием 6 на рис. 16-1 раскрывает различие между физическими деталями и информацией о частях изделия. При ответе на важный вопрос или изложении новой идеи, возникшей в процессе анализа комментариев, запишите синим цветом рядом с комментарием новое замечание "с кружком" и соедините его с комментарием зигзагом. Помещение новых замечаний в откомментированную папку вполне допустимо.
Записывая ответы или дополнительные замечания, руководствуйтесь указаниями о конструктивности замечаний. Они имеют к этому прямое отношение, потому что авторы должны быть внимательны к читателям во время ответов. Особенно важно помнить о том, что каждый читатель смотрит на вашу работу со своей точки зрения. Например, у мастера могло не быть претензий к диаграмме обработать рабочий комплект , в отличие от рабочего просматривавшего папку. Кроме того, рабочему было трудно понять, что законченное или незаконченное задание и его статус - это принципиально разные вещи. Мастеру, возможно, легче уяснить это различие. Поэтому авторы должны быть внимательны к мнению каждого читателя и реагировать на замечания, приводя при необходимости объяснения и обоснования.
Рис. 16-1. Титульный лист и родительская диаграмма с ответами автора
Рис. 16-2. Диаграмма и дополнительный материал с ответами автора
16.2. Беседа автор/читатель
Иногда возникают серьезные разногласия, существенное взаимное непонимание или остается непонятым важное замечание. В подобных случаях запишите эти проблемы на титульном листе в форме замечания. Мы рекомендуем в конце каждого такого замечания писать заглавными буквами слова ДАВАЙТЕ ПОБЕСЕДУЕМ. Это укажет читателю на ваше желание провести диалог автор/читатель для более тщательного обсуждения разногласий. Сделав это, вы продемонстрируете читателю ваше желание к интенсификации обратной связи. Но прежде чем вы встретитесь, подготовьте список вопросов, которые следует обсудить в ходе беседы автор/читатель. Проведите встречу и рассмотрите последовательно все вопросы один за другим. Выработайте решение каждой проблемы и запишите его в папке в виде замечания "с кружком".
Во время встречи придерживайтесь запланированной тематики и старайтесь уложиться в один час. Может оказаться, что встреча затянется из-за того, что вопросы потребуют дополнительного обдумывания или возникнут новые проблемы. Запишите новые проблемы и быстро вернитесь к исходной теме. Если потребуются дополнительные размышления, мы не советуем вам продолжать встречу намного дольше часа. Наш опыт показывает, что после часа интенсивных размышлений над сложной проблемой начинает падать продуктивность беседы. Лучше договоритесь о новой встрече и составьте к ней новый список вопросов. Такой стиль концентрированного взаимодействия очень эффективен, потому что: (1) цикл автор/читатель позволяет разрешать небольшие проблемы без дополнительных обсуждений, (2) ваша беседа будет короткой и насыщенной благодаря заранее подготовленному перечню вопросов.
16.3. Обобщение читательских комментариев
Каждое замечание, с которым вы согласились, приводит к изменениям в исходной диаграмме. Зафиксируйте эти изменения с помощью замечания "с кружком" на своем экземпляре папки. Используйте всю мощь графического языка и языка ссылок SADT для того, чтобы быстро делать примечания и легко и аккуратно вносить изменения в диаграмму. На рис. 16-3 показаны примечания, сделанные к диаграмме выполнить задание после обработки читательских комментариев. Обратите внимание, что изменения терминологии привели к изменению метки дуг. А это в свою очередь заставило автора сделать более тесной связь между результатами обработки и законченным и незаконченным заданием.
Часто в процессе реагирования на несколько откомментированных папок два читателя могут дать автору ценные, но противоречивые указания. Когда это случается, автор должен выбрать то из них, которое больше согласуется с целью и точкой зрения модели. Если это вызывает затруднения, автор должен провести беседу автор/ читатель с обоими читателями одновременно для разрешения противоречия. Окончательное решение, которое, как правило, является компромиссом, записывается в авторском экземпляре папки. Даже если конфликта нет, автор может не полностью следовать предложению читателя. Это относится к ситуациям, когда комментарий поднимает очень большую проблему, предлагает большие изменения в модели или когда указанный недостаток может быть устранен не так, как предлагает читатель.
Помните, что внесение записей в свой экземпляр папки - не напрасная работа. Часто в процессе нее авторы вносят новые качественные изменения в диаграммы в дополнение к тем, что предлагают читатели. Это происходит потому, что авторам в ходе обобщения комментариев представляется возможность увязать и объединить идеи сразу всех читателей, что часто приводит к новым плодотворным идеям, реализация которых ведет к новым качественным изменениям исходной диаграммы. Например, на рис. 16-3, усилив связь между результатами обработки и законченным и незаконченным заданием, автор проанализировал возможность обратной связи между изготовить на станке и собрать и определить степень выполнения задания . Это привело к добавлению новой дуги изменение плана , которое отмечено замечанием 7.
16.4. Переделка диаграмм
Принято или непринято какое-либо замечания читателя отметьте в вашем экземпляре папки. После этого вы готовы к переделке рассматриваемой диаграммы и всех других диаграмм, которые были затронуты. При серьезных изменениях мы рекомендуем начертить диаграмму заново. На рис. 16-4 показан результат перечерчивания в соответствии с примечаниями к диаграмме выполнить задание, приведенными на рис. 16-3. Обратите внимание, что замечание 7 заставило автора ввести обратную связь по управлению от блока 4 к блоку 1 и что автор поменял ее метку при переделке диаграммы.
Рис. 16-3. Диаграмма с комментариями
Рис. 16-4. Перерисованная диаграмма
Если вы чертите диаграмму заново, не забудьте отметить заменяемую диаграмму, указав ее С-номер в скобках сразу же после С-номера новой диаграммы, как показано на рис. 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, April 1970.
- 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.