人月神话札记：提纲挈领

前言：所谓提纲挈领，从字面上讲就是抓住渔网的总绳，提起衣服的领子，其含义（度娘说要用含义而不推荐用涵义）就是告诉我们做事情要能够抓住要领。那么本篇告诉我们什么是要领呢，就是书面文档，从一开始就要意识到其重要性，那么就不会对文档产生厌烦。因为作为技术人员来说，包括我，普遍对文档没有好感，尤其是看完了长篇大论后，发现无非就是要表达一两句话，那时候，就会气急败坏。

计算机产品的文档

对于该小节，我读了三遍，发现并没有很好的理解，所谓预测->报价->价格之间相互制约的关系，没有弄出来个所以然。希望在以后再次翻阅的时候能够有很好的理解。

但是有一点，我觉得是个真理，那就是预算是一种制约，会促使产生更好的技术方案，因为如果在预算不能满足当前项目所需的话，我们就会被迫去做出改变，去探索出更具有性价比的产品解决方案，这促使了整个社会的发展。

大学科系的文档

任何管理任务的关注焦点都是时间、地点、人员、项目内容和资金。

Brooks给出的这个观点，我想没什么可说的，当你搬家告诉别人的时候，短信的内容就会是“各位亲爱的伙伴们，我将于4月17日搬家至洛阳牡丹广场，届时欢迎大家光临做客，我们将在老洛阳开吃一顿”。

软件项目的文档

就目前的自己来说，在安排任务的时候，多数是通过口头传达，然后在禅道中加入任务和时间，用来管理进度。而当一个任务结束后，等我再次回头来进行总结的时候，发现我的记忆力不够清晰了，往往这个时候，我非常的怀念有一份文档能够以书面的形式存在。

还有很多很多时候，对于一个开展的迭代，或者说一个关键的任务，或者说一个证明给别人的数据，强有力的文档会让所有的事情变得清晰明朗。

为什么要有正式的文档

这个看似疑问句的标题，其实更像是一个反问句，其答案必须是斩钉截铁的，正式的文档是必须的。

最近在做华夏银行的三方存管平台对接工作，最开始，对这个对接的工作只有几个字的概念，就是“华夏银行对接”。如果华夏银行没有提供给我必要的技术、业务说明文档，我的印象恐怕只能滞留在这六个字上了，虽然拿到他们的文档后，阅读过几次后都感觉到无力，如今都2015年了，文档的做成时间竟然是2011年，我不相信这4年来，业务接口一点没变，凭我的直觉，后来又要到了两份2014年做成的文档。然而，我不应该吐槽这些文档，我知道，正是这些文档，促使我去思考，去讨论，去交流，去分析，去编码，现在我已经把接口的代码工作完成了， 接下来就是测试和上线。

那么这些文档的作用显然是价值连城的，无论它的质量是否满足我的预期。

项目经理的任务就是制定计划，并且实现计划。但是只有书面计划是精确和可以沟通的。通过遵循文档开展工作，项目经理能够更清晰和快速的设定自己的方向。

显然，一次次的任务终结，其最让我能够感到满足除了任务一次次终结，还有那被我折磨的文档。