在这周之前,我们项目小组已经写了立项说明书、需求分析说明书、概要设计说明书、详细设计说明书,但是在老师给出的模板之后,发现我们所写的文档与老师给出的模板仍具有很大的差距。所以这周的工作中,有一部分就是改文档的工作。虽说各种文档的格式或模板不是一成不变的,但是,在老师的要求下会是我们的文档较之前更加严谨,写文档的能力得到一定的提高。
软件过程中,文档本来就是产品的一部分。而且文档经常被作为里程碑标记,使项目跟踪和控制变得可能,也使软件生产的每一部分都可前溯,保证软件的质量。所以我们组都会认真对待所写的每一份文档。正如老师在上课的时候提到流程图的画法时,说到我们之前的基本都画错,因此对于每次有画图的部分,我们都会认真查找资料后再着手画,保证速度的同时一定保证质量。就这样,仅仅是通过写文档,我们又可以对之前学过的知识进行巩固一下。
对于各种文档,据我在网上的了解,软件开发人员不愿意写文档,我想这主要指的是刚参加工作时间不长的工作人员。大体的原因应该有:
(1)软件开发的大环境不好。(2)重技巧的学习,而轻视能力的培养,我国的软件开发人员重视对技巧的学习。(3)重视表面的东西,轻视基础,说到的基础就如:数据流图,数据库设计中的1NF,2NF,3NF,BCNF。(4)对系统不了解,是写不好文档的最主要的原因。调研人员对客户的流程并没有作到真实的了解。同时为了避免被别人发现问题,最好的方法当然是不写文档,避免暴露自己的不足。(5)不会讲问题分层次,复杂问题讲不清楚,是开发人员不写文档的另外一个原因。简单一点就是没有学会处理问题的方法,不会将复杂问题分层次,不会将问题分解为简单问题,逐个处理。(6)糟糕的写作功底,是不写文档的一个原因。我们是学理工,文字功力差一点没有关系,这是很多软件人员的说法。(7)最后一个原因,这是一个很实在有很尴尬的现实,很多人没有进行过正规的开发,甚至没有见过真正‘好’的技术文档,自然就不能感受好文档的作用,于是认为现在这种糟糕的文档就是最好的,而这些文档对开发没有任何作用(反而耽误时间),自然就不愿意在写文档了。