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

原创 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
  • 923

Ajax交流文档[转]

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

沟通,不要从否定开始!

最近发现电视剧里宣传的任务的性格,都是模拟当下的最多的人的性格去的。这也难怪,这样才能引起大家共鸣嘛。可是,这样却也少了媒体的功能,教化大家如何做好沟通,变得毫无参考。我们往往是在学人做事。做人,很多...
  • xiammy
  • xiammy
  • 2010年12月06日 15:23
  • 4150

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

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

交流耦合与直流耦合

交流耦合(AC Coupling)就是通过隔直电容耦合,去掉了直流分量直流耦合(DC Coupling)就是直流、交流一起过,并不是去掉了交流分量。比如在3V的直流电平上叠加一个1Vpp的弦波,如果用...
  • abvedu
  • abvedu
  • 2017年03月24日 09:18
  • 561

Python -- Html转PDF

html->pdf
  • wudj810818
  • wudj810818
  • 2017年08月09日 16:32
  • 553

Ajax内部交流文档

一、使用Ajax的主要原因  1、通过适当的Ajax应用达到更好的用户体验;  2、把以前的一些服务器负担的工作转嫁到客户端,利于客户端闲置的处理能力来处理,减轻服务器和带宽的负担,从而达到节约ISP...
  • imDaBaiCai
  • imDaBaiCai
  • 2008年09月13日 22:07
  • 306

Ajax内部交流文档

一、使用Ajax的主要原因  1、通过适当的Ajax应用达到更好的用户体验;  2、把以前的一些服务器负担的工作转嫁到客户端,利于客户端闲置的处理能力来处理,减轻服务器和带宽的负担,从而达到节约ISP...
  • mengxin846
  • mengxin846
  • 2007年05月05日 09:31
  • 496

交流文档的重要性

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

Ajax交流文档

一、使用Ajax的主要原因  1、通过适当的Ajax应用达到更好的用户体验;  2、把以前的一些服务器负担的工作转嫁到客户端,利于客户端闲置的处理能力来处理,减轻服务器和带宽的负担,从而达到节约ISP...
  • lucky_yyx
  • lucky_yyx
  • 2007年03月29日 16:38
  • 396
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章: 文档、交流方式- - 【转】
举报原因:
原因补充:

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