公司内部有这样一句话:所有人都渴望有文档,所有人都不喜欢写文档。深有体会深受其害。
文档是沉淀,是历史经验的总结,是走过的路,埋过的坑。前几年,包括现在,印度人的软件工程很是厉害,review是他们的软件质量大法。而review的整个过程每一个细节都能在文档上找到。和印度客户打交道,除了咖喱味的英语难懂,还有就是验收时各种文档的打回重写。不仅仅是印度人,东南亚的很多运营商,都十分重视文档开发工作。
作为一个设备制造商,我们走出国门和曾经的通信巨头去pk,技术上并无差距,但在文档领域,简直弱爆。虽然现状上那些曾经风光的大公司如今合并得合并(例如阿尔卡特朗讯诺基亚),消失的消失(例如北电、摩托罗拉)勒紧裤带过日子正在死扛(例如爱立信),但企业的文档意识及文档体系,我们相差的距离还是十分遥远。
今天的想法是来自一个调了三天的部署环境的加班狗对于不严谨的文档的无力吐槽。想起来,工作文档之外,人生的其他领域同样需要review和过程文档化。让自己不断总结,再指导前行。
写下来的意义就在于此吧……