程序员在项目里不读写文档会有什么后果

程序员在项目里不读写文档会有什么后果

程序员在项目中经常犯的错误，那就是既不读、也不写文档。这会造成什么后果呢？

第1个故事，发生在几年前，我刚到一家电商负责组建PMO，PMO里的一名项目经理负责一个系统升级类的项目，这个项目的需求有着复杂的业务逻辑，为了把复杂的业务逻辑描述清楚，不愧是PMO的项目经理，不仅把业务规则用文档的形式写的极其详细，绝对没有产生歧义的可能，而且还甚至于把数据从哪张数据库表的哪个字段取出来都写的清清楚楚，不仅如此，为了详细描述页面的交互，项目经理还画了很详细的原型图，导出生成原型之后就把需求文档和原型交给了技术团队做初步的评估。

几天之后，技术团队的负责人拍着胸脯和项目经理说，你就放心吧，需求很清楚，我们知道该做成什么样了。因为项目经理也是刚到这家电商，对于技术团队心里没底，所以就建议给技术团队讲一次需求，但是技术团队的负责人说没有必要，你写的需求已经很详细了，我们直接做就可以了。既然技术团队负责人如此坚持，而且新来的项目经理也想观察一下技术团队的真实水平，也就没有坚持给他们讲需求，只是约定按照进度计划来分模块验收。

很快，第一个模块按计划开发完成了，项目经理按照约定来做模块的初步验收，结果让人震惊，那就是开发完的页面交互逻辑和需求有很大的差异，不仅如此，项目经理还发现开发出来的业务逻辑和需求不一致。到了这个时候，项目经理的脑袋已经大了，在和程序员确认后才知道，程序员在开发的时候根本没有看需求文档，而是跑去找开发团队负责人来给他们讲需求，而技术团队负责人自始至终都没有认真看过需求。

结果是什么呢？项目经理绝不让步，坚持让技术团队返工，技术团队无奈，只好在项目经理的要求下全员仔细听了一遍需求，然后全体返工，在付出了额外的时间和精力之后，系统终于实现了交付。

上面说的是程序员不爱读文档，对于写文档，程序员就更排斥了。

第2个故事，发生在另一家电商，当时我刚完成一个战略大项目的大型系统上线，整个上线过程非常圆满，这个时候，一个技术团队的负责人找到我，和我说他们项目上线经常出问题，就向我咨询怎们才能让项目上线不出差错。

在了解了他们项目上线的方法之后，我给他们的建议是：如果不想出差错，就必须要做好上线计划，上线计划需要按照我的模板来写，而且每次上线都要测试和评审上线计划。

技术团队的负责人在看了我的上线计划之后连连摇头说，这么细的上线计划我们可做不出来。然后就没有然后了。这个技术团队在之后的项目上线继续出大大小小的问题，但是因为这个技术团队和对口的业务部门关系非常好，所以除了几次大的上线问题确实没法交代，被老大拉出来批，其余的时候倒也相安无事。

通过上面2个故事咱们看到了，有的技术团队宁可选择加班、返工、出上线问题、挨老大批，也不愿意在文档上下功夫去解决问题。

是所有的程序员都有这毛病吗？当然不是。而且不爱读写文档的毛病其实有些时候不是程序员的毛病，而是团队或者是组织的毛病。

当然，也有一些程序员和技术团队是比较重视文档的，我就碰见过几个这样的团队，重视文档的团队在开发的质量和效率上普遍都比较高，我还甚至于通过综合运用包括文档在内的多种需求方法造就了一个基本上没有BUG的项目，这个项目一做完，程序员、技术团队负责人和测试工程师都信心爆棚。