文档很重要

昨天接到客户一个比较急的工作事项，其实以往也同样的事情做过很多次，基于我们之前开发实现的一个DEMO系统，整理一些演示场景，给领导汇报应用建设思路和目标。

DEMO应用，运行一直挺稳定的，常规的异常处理也不复杂，简单说，重启下服务进程就可以了。

但是，今天，异常出现了，重启却解决不了了。再然后，就没办法了。

这部分代码的实现人员早已经离职了，之前交接这部分工作的同事交接时却没有仔细完成交接。导致，遇到稍微复杂的问题，就只能干瞪眼了。

这部分应用没有任何相关的设计和维护文档。代码里面没有任何注释。这部分工作前期的管理真是一塌糊涂。

下午找了四个熟悉同类开发工具的开发人员一起定位问题，最后问题定位了，但是却解决不了。找不到问题对应的模块部署信息。

记录这些部署信息的部署文档缺失。

一下午，四五个人的工作量付之东流。就因为缺少文档。足见技术文档的重要性，在有些时候，真的是决定成败的。

当然，造成最重要的极其尴尬的境遇的还是整体管理上出了问题，人员离职交接、工作任务分配、接口职业切分全都没有有效规划和执行。

文档是直接因素，管理流程是核心因素。

引以为戒。