在很多公司,一个有趣的现象是SQA人员或者公司高层拼命要求工程师写文档,而工程师也上有政策,下有对策,玩起了捉迷藏的游戏.总是找着各种各样的理由来逃避.
你要我写文档,可以啊,但是现在我事情这么多,根本就时间来写文档啊. ---- 没空,怎么办?
写文档,好啊,可是我们需要时间,在项目开发计划里面要加上设计的时间,这样其他的阶段都要往后推.这可触动了我们可爱的项目经理的神经,他急匆匆跑出来说NO.
我会写设计文档的,但我现在还不知道怎么做,请问怎么写啊?我现在在试,在写代码试试看能否成功.---无奈吧?他愿意写可是他现在不会做啊?Kill him ?
好的好的,我正在整理,等代码稳定后我会补上设计文档的,你放心.
设计文档?哦,还没到这个时候呢,这个feature还不知道要不要做,高层还没定.所以还没到设计阶段啊.
看着上面的种种推脱,SQA灰溜溜地跑回自己的位置,一点办法都没有.
在研究对策之前,我们来分析一下这背后的故事.他们为什么不愿意写设计文档呢?这导出另一个问题,我们为什么要软件工程师写文档呢?有什么好处吗?我把这个问题问了不同的人,老总说,你要是不让他们写文档,要是以后他们走了后怎么办?新的人员怎么熟悉项目?不就是看文档来熟悉吗?一句话,要让工程师把大脑里知道的东西交出来.好阴险,在中国的公司,很少有为工程师考虑的领导,把他们的东西交出来,然后他们就不能调皮了,想走就走吧,新人来也可以替代你,工资不满意?很高了啊.想起一位软件泰斗的话,管理工程师就象放牧一群孤傲的猫,如果这样的话,岂不变成放牧一群温顺的绵羊,这可是我们的多少代领导梦寐以求的啊.
出了老总的门,我跑来问SQA工程师,我问他们为什么要写设计文档啊?"不写设计文档,你的代码怎么产生的?"他很惊讶我这个多年软件经理居然问出这样的问题."代码产生很容易的,就这样产生的啊?用手敲键盘"我轻描淡写地回答."那你这样产生的代码质量一定很差吧?你这样会浪费更多的测试和debug时间.""是啊,"我回答道,"但是我节省了设计的时间啊,我就通过调试来稳定程序的".他好象没辙了,拿出他的杀手涧,"不是我要你写的啊,是老板要你写的".老板?知道吗?不写呵呵,后果很严重的.... 我并不满足这样的答案,SQA总是把老板请出来并不是一件好事,也许他们也为了完成他们的任务,大家都不写文档,SQA人员交不了差啊,所以我看到很多很多的设计文档,那简直是一堆狗屎,纯粹是为了交差凑数的.让我问他们写了文档没有的时候,他们都响亮地回答,写了.于是SQA经理开心地吹着小调走了.
其实我{BANNED}最佳应该问的是工程师,当他们写的时候,问他们为什么要写这个文档?当他们不写的时候,问他们写这个设计文档会有什么麻烦?我静静地坐着,我没去问,因为我知道他们心里想的什么.
我开了一个小会,叫上了几个工程师和项目经理,来说说我门的现状.我在黑板上画上2副图,一副是不写设计文档的项目图,我们的工程师都非常优秀,他们很快就把基本功能完成了,经常提前出了{BANNED}中国第一个demo,让项目经理感到意外的惊喜.但是噩梦也随之而来,{BANNED}中国第一个demo被退回来了,因为根本就不能用.马上第2个demo出来了,还是被退回,因为不到3分种,我们的软件就死了.就这样一个demo一个demo地出,终于可以亮相了,但是测试组总是发现一些很奇怪的问题,这些问题就象CFO一样,永远难以重现.这时候,我们都傻了,有时候一两周大队人马才找出一个bug,这还不能保证问题的解决,因为也许有3个,5个或者更多的原因导致这个问题,我们找到了一个原因,还有其他的会导致这个问题? who knows ? 我们的项目经理越到项目后期就越急了,而我们的工程师也很疲惫,一点成就感都没有,还脱不了身,总是盼望项目的快点结束.
我又画了另外一副图,开始工程师要写设计文档,当然需要时间,{BANNED}中国第一个demo的时间需要往后延.可是由于我们写了设计文档,而这些设计文档被有经验的人员review和讨论过,这保证了在大的框架方面没出多少问题,以后的bug很少会修改到框架(如果有,那就是design 的失误). 我们会发现,测试和bug修改的时间大大减少了,这样对大家都有好处.工程师也可以去做新的东西.
于是,我们大家一起来尝试这种新的开发方法.大家一起来努力了...
