软件开发不能忽视软件开发文档书写

发表于:2015-06-10 14:28:18
【内容导读】很多软件开发人员觉得写软件开发文档烦锁且降低工作效率 , 我认为主要是先已编码开发后补软件开发文档 , 软件开发文档并没有对系统开发起到实际的作用产生的。对于能给开发起到实际作用系统设计、分析软件开发文档谁都不会认为是多余的。软件开发文档应该适

 

很多软件开发人员觉得写软件开发文档烦锁且降低工作效率,我认为主要是先已编码开发后补软件开发文档,软件开发文档并没有对系统开发起到实际的作用产生的。对于能给开发起到实际作用系统设计、分析软件开发文档谁都不会认为是多余的。软件开发文档应该适合软件开发过程相匹配一种表现形式,管理和技术是一个层面的,软件开发文档和开发过程是第二个层面上的。

1、软件开发文档是记录软件开发过程的一种重要手段,她是基于软件开发过程的一个非常重要而且是必不可少的表现形式;
2、软件开发文档与软件开发过程的关系就像项目中管理与技术的关系是十分类似的:

以前有人争论过管理和技术哪个更重要的问题,在我看来:过于注重技术会造成开发过程的人为因素过重,失去了有效的项目可控性。而管理过重的时候,会造成技术人员很强的失落感,影响开发人员的士气,乃至于项目延期,无人愿意承担责任。

而软件开发文档和软件开发过程也有类似的关系,过于注重软件开发文档,形式化太强,会造成大量的时间浪费,最终项目延期和经费的利用率降低等结果。而只注重过程忽视软件开发文档,则会造成项目失去了可控性,因为没有可以用于追踪的有效记录,也就无法检查项目的进展状况,造成项目的失败。
3、软件开发文档应该注重实用,根据不同软件开发文档的用户来制定软件开发文档的内容,同时根据项目的不同调整软件开发文档的结构、数量、种类以及侧重面。

对于软件开发的软件开发文档,我认为非常重要,软件开发文档也是产品的一部分,是一定要写好的。一两次口头交流可能比软件开发文档的成本要低,但几十次、上百次呢,何况口头交流是不精确的,不完整的。花一点时间来编写软件开发文档,我认为是完全必要的工作。而且软件开发文档的编写应该尽量完整和详细,对此应该开发良好的软件开发文档模板,供编写人员填写。

软件开发文档当然要注意实用,很多开发人员对编写软件开发文档感到厌恶,难写,我觉得很大的原因是他们并没有对软件开发进行充分的考虑,很多软件开发文档里面要求写的东西他们从来就没想过,只有瞎编一通,当然心里会厌恶。