文档、交流方式- - 【转】

原创 2004年07月06日 16:16:00
http://www.blogdriver.com/showBlog.do?bloggerID=26189&diaryID=223518
文档、交流方式- - c2-.gif
  
今天在javaeye上看到一篇文章,讨论文档的价值。忍不住就回了一帖。
考虑到打那么多字不容易,最近又一直没有写blog,所以贴到这里来,算是冒个泡泡,表示我还活着吧。
13.gif
 
呵呵,这个问题是我很关心的。我总是把它称为Effective Documentation,而且把它看成是Effective Communication的一个重要组成。 
:P
Effective Documentation的最重要的一条就是何时需要文档。
交流的手段有很多,隐喻、讨论、面谈、使用文档……
要做到Effective Communication,我们就要在合适的地方使用合适的手段。
要决定Who和When,我们首先要理解What、How和Why。

隐喻经常出现,但是不是那么靠得住。如果在出现错误之后,当事人说:“我以为……”,这就表明在需要细致可靠的地方使用了隐喻这种不太靠得住的东西。

讨论和面谈都是性价比极高的东西。
它们的表现能力非常强,精确性也极高。人可以通过重音来强调自己想要表达的重点,比如“Mary had a black sheep”。文档也可以用字体、颜色等来强调,但是它没有针对性。比如针对“What an animal did mary have”,人会回答“A black sheep”,但是文档不会。
这是因为文档没有智能。在讨论和面谈中,交流的每一方都具有智能,这使得交流更加丰富和准确。继续上面的例子,如果再问“That is to say, Mary has nothing now?”,人就可以回答“Yes, what a poor gril!”,文档则完全没有办法直接回答。
之所以出现这些优点,我觉得本质的原因在于交流的载体和使用载体的方式上。
这里的载体是声音,这是一个极其廉价的载体,其成本可以看作0。而它的使用方式,严格遵守着“使用时创建,使用后抛弃”的原则。(呵呵,插一句,这种思想在对象的构造与析构上也是有指导意义的:P)这种使用方式降低了载体的地位,真正实现了智能双方的亲密接触。

使用文档的可靠性和稳定性最高。
文档这种载体的跨越时间和空间的可靠性和稳定性,是声音这种载体望尘莫及的。但是,目前看来,大部分的文档的成本都很高,因此很难做到“使用时创建,使用后抛弃”。部分CASE工具能够降低某一些文档的成本,但是这些工具本身就非常昂贵。
对文档最常见的误用就是用来刻画随时变化的东西。我们有一个老掉牙的故事,叫做“刻舟求剑”,但是看来很多人对这个故事没有太深刻的理解。现在大部分的文档都跟独孤木说的一样,“记载的是历史上的某一天”。所以我们要注意文档的运用,借用侯Sir的话,“勿在浮沙筑高台”(呵呵,跟他书上原意完全不一样喔:P)。

Blog - 第四种网络交流方式

Blog,就是网上日记  一个Blog就是一个网页,内容就是一个个倒叙排列的日记体帖子,频繁更新并充分利用超链接。Blog是一种工具;Blogger是指使用这种工具的人。  第四种网络交流方式  在这...
  • amgod
  • amgod
  • 2004-12-02 11:18:00
  • 1095

Ajax交流文档[转]

一、使用Ajax的主要原因  1、通过适当的Ajax应用达到更好的用户体验;  2、把以前的一些服务器负担的工作转嫁到客户端,利于客户端闲置的处理能力来处理,减轻服务器和带宽的负担,从而达到节约ISP...
  • jinru2560
  • jinru2560
  • 2005-12-15 11:53:00
  • 680

网络十五年,从交流方式的变迁看永恒人性,并预测未来交流工具的发展方向

我97年从学校毕业,到现在2012已经整整十五年了。十五年一直从事IT方面的工作,科技进步真可谓是月新日异,交流工具用过BP机、固定电话、二哥大、移动电话、手机等等。比起科技的进步,这十五年中人性的改...
  • zjyklwg
  • zjyklwg
  • 2012-01-22 15:02:53
  • 740

交流文档的重要性

今天mentor善意提醒我了,虽然我是学计算机的,但是文档很重要很重要。虽然以前一直讨厌给老板写比较清晰的交流文档,觉得和老板之间这么费时费力交流很没有必要,觉得是表现自己的一种可耻的行为。可是今天s...
  • lhq9220
  • lhq9220
  • 2011-07-26 11:24:58
  • 425

数字化时代已经改变了我们的沟通方式

数字化时代已经改变了我们的沟通方式。在过去十年中,电子邮件、网络和手机的运用,已经遍及世界各地。在未来十年内,可能会看到数字标牌(Digital Signage)享有同样的发展和普及,当商业与非商业机...
  • dubj186
  • dubj186
  • 2009-08-19 13:24:00
  • 631

敏捷测试理论以及实践 - 1

【本篇是《敏捷测试理论以及实践》第一篇,(第一篇,第二篇,第三篇,第四篇,第五篇,第六篇,第七篇)】   前言: 关于敏捷测试这块内容,本来之前一直想写的,但是自己一直觉得还没法归纳得很好,不过...
  • softerwarer
  • softerwarer
  • 2011-10-17 21:48:52
  • 2275

学习一门新技术的方法

工作中要学会的其中一点,就是对某项新技能的学习。最近android很火,不少公司利用之开发新产品,也有不少人在学。不过,一旦将来android降温,或者有其他的新技术出现,势必会掀起新的一波学习潮。个...
  • kelehaier
  • kelehaier
  • 2016-12-10 15:26:57
  • 194

【软件工程】初识软件

随着微电子
  • u013040472
  • u013040472
  • 2014-11-09 19:32:13
  • 852

交流感应电动机控制方法.doc

  • 2008年10月19日 14:12
  • 202KB
  • 下载

几种伺服电机控制方式介绍

  • 2011年05月17日 12:08
  • 7KB
  • 下载
收藏助手
不良信息举报
您举报文章: 文档、交流方式- - 【转】
举报原因:
原因补充:

(最多只允许输入30个字)