有些软件公司做项目时,要求软件文档必须做到面面具到,完善到所有细节,这是非常浪费人力物力的做法。而有些公司却为了节省成本,什么文档也不做,口头沟通业务流程,确定下来后直接交给开发人员,这样的后果我在一篇文章里面已经提到过:程序为啥看起来简单,做的时候却很难
过去完善的文档会消耗太多成本,太少的文档却使得开发寸步难行,那我们应该如何把握开发中的文档要求呢?
针对不同的项目使用不同的要求即可,根据项目的难易程度,选择合适的文档要求
很多人会说,这样的想法很好,弹性很大,如何选择“合适”的文档要求呢?
对于没有做过详细文档的公司需要拿一个项目来做一次全文档开发,让开发人员对所有需要建设的文档有所共识,然后归纳总结各个模块的特点和难点,对必须要做的文档和可做可不做的文档进行总结,做到“小道至繁”,以便总结经验,同时让大家对文档产生共识,系统需要做什么样的文档,如何来做,这个事件一定要有共识,这步非常重要
做好前面那一步后,在将来的系统中,先对系统复杂度进行分析,复杂度这个东西是没有尺子的,需要大家用心分析,也可以确定一个流程,在开发前把功能做个列表出来,对于需要做文档的地方进行讨论,其实这一步开发部老大可以先做决定,如果开发组成员觉得有分歧时可以提交会议进行总结,经过多个项目的总结之后,最终可以做到“大道至简”,对项目选择合适的文档要求,最快速度的完成项目,节省开发成本