面对面沟通与文档沟通

1994年McCarthy J.和Monk, A.在一篇论文"Channels, conversation,cooperation and relevance: all you wanted to know about communication but wereafraid to ask"中给出了下图所示一个研究结论。即在所有的沟通方式中，两个人守着白板，边讨论边写写画画地进行沟通是最高效的。

在敏捷的方法中强调了人和协同胜过过程与工具，能够运行的软件胜过了复杂的文档，而在传统的方法中强调了文档驱动，因此在实践中也就产生了很多误解，有的人认为规范的方法就是一堆文档，敏捷方法中不用写文档。到底文档与面对面的沟通之间的关系是怎样的呢？我们需要有一个深刻的思考。

没有文档，只有面对面沟通，一切都是传说。

没有面对面沟通，只有文档，到处充满误解。

有文档也有面对面沟通，有面对面沟通也要有文档，二者缺一不可。

可以先文档，再面对面沟通，也可以先面对面沟通，再文档，迭代交替进行。用面对面沟通达成共识，用文档记录共识。

可以多面对面沟通，频繁面对面沟通，双向反馈沟通，少文档，简单文档。面对面沟通可以验证理解的一致性，文档单向传递信息，无法确定读者与作者理解一致。

有的时候可以多面对面沟通，少文档，比如周期紧张的时候，因为面对面沟通的效率更高。

有的时候可以多面对面沟通，多文档，比如时间宽松的时候。

有的时候可以少面对面沟通，多文档，比如要规避法律风险的时候，因为文档可以更加严谨，更易于保存，易于检索，可以作为呈堂证供。

有没有少面对面沟通，少文档的时候呢？基本不太可能，是小概率事件。误解的风险很高！

有的时候可以先面对面沟通，简单写文档，然后再补充完善文档，比如要考虑维护请求的时候。

有的时候可以逆向工程根据代码生成文档，以节省写文档的时间，而又为维护者提供理解设计的思路。

有的时候可以用代码替代详细设计，前提是你的代码足够好！

一体两面，互为依存，谁重谁轻，灵活裁剪。

面对面沟通与文档沟通相关推荐

反思：项目开发中的语言沟通与文档沟通
反思:项目开发中的语言沟通与文档沟通问题引出:刚进入公司试用期,有导师安排开发实现一些功能模块或者小的应用.毕竟需要在整个产品的框架下添加代码,看了下整个产品近1G的源代码,相当浩瀚.虽然是不需要我 ...
28份R语言文档沟通推文汇总
简介小编对以前写过的关于 Rmarkdown 相关教程进行汇总,方便自己以及读者查阅.公号建立半年多时间了,回顾这个系列,感觉还是挺有意义的.视频教程和推文结合,让更多的伙伴们(甚至,现在越来越多统 ...
演讲：文档什么鬼分享会 | 技术传播
作为一个初创技术公司,我司的信息管理水平,基本还停留在茹毛饮血的原始水平.领导让我给全公司的同事做一个分享,说是要提升一下文档意识的水位.作为一只热爱解决具体问题的攻城狮,竟然勉强我去讲"哲 ...
为啥开发的文档能力是核心竞争力之一
在开发团队里面一般产品的文档能力会比较强,很多开发的文档能力都非常弱,在我看来文档能力是一个程序员核心竞争力之一,文档能力强才能实现能力的快速发展.为什么语文在中小学课程里面比重那么大,因为语言能力是 ...
[aspnetcore.apidoc]一款很不错的api文档生成工具
简单徐速一下为什么选用了aspnetcore.apidoc 而没有选用swagger 最初我们也有在试用swagger,但总是有些感觉,感觉有点不满意,就但从api文档角度来说,从前后端文档沟通角度来 ...
顶级产品经理是如何写产品需求文档（PRD）的
产品需求文档(PRD)对每个产品经理来说都不陌生,它是产品项目由"概念化"阶段进入到"图纸化"的转折和体现,作用是"对市场需求文档(MRD)中的内容进 ...
干货|我的三年产品基本功之PRD文档攥写
产品基本功不仅是基础最近刚好负责的一个UGC模块已经进入文档阶段.本文为各位朋友带来一个产品基本功的分享--产品需求文档,这一篇分享将是我3年产品进阶到今天,个人要求需求文档目前的撰写标准. 从腾讯 ...
那怎样的文档才是好的产品文档呢
看来的一篇文章,挺有意思的,来源于哪,忘记了那怎样的文档才是好的产品文档呢? 其实,产品文档的作用就是为了高效地传递产品经理对产品功能的描述. 只要是能够顺畅推动项目前进,在产品开发和测试过程中能够 ...
PRD(产品需求说明文档)与MRD(市场需求文档)介绍
文章目录目录一.PRD(产品需求文档) 1.确定PRD文档格式 2.确定项目概述 3.项目功能描述 4.产品经理的思维体现在这几个方面: 5.大厂PRD常见规范: 6.PRD的最终目的: 二.MR ...
博智云书 | 建筑工程文档管理好帮手
为了规范建筑工程档案管理工作,国家住建部.档案局.发改委等部委出台了一系列促进电子化档案管理的政策和指导办法.随着政策的推广,建筑行业档案电子化已经成为主流,我们仍需进一步借助数字化文档管理手段,提升 ...

面对面沟通与文档沟通

面对面沟通与文档沟通相关推荐

最新文章

热门文章