Оригинал: Why IT communications fail to communicate
Автор: Боб Льюис (Bob Lewis)
Не путайте документацию с коммуникациями! Назначение документации — не передавать информацию, а служить напоминанием.
Бизнес-аналитик моего клиента спросил, как я оцениваю качество разработанной спецификации.
Я давным-давно я убедился на собственном опыте: когда кто-то просит вашего совета, скорее всего он ищет союзника. Поэтому в ответ я поинтересовался, откуда у него возник этот вопрос.
«Я отдал документ разработчику, а он сказал, что это плохая спецификация. Поэтому я хочу узнать ваше мнение.»
Понятно: нужен союзник. Те мне менее, я взглянул на эту спецификацию. Сам по себе документ был неплох. Но, как и многие другие документы, он был плохим по простой причине: бизнес-аналитик использовал ее в качестве средства передачи спецификаций разработчику.