zoukankan      html  css  js  c++  java
  • 第七周作业-谈谈各种文档

      在这周之前,我们项目小组已经写了立项说明书、需求分析说明书、概要设计说明书、详细设计说明书,但是在老师给出的模板之后,发现我们所写的文档与老师给出的模板仍具有很大的差距。所以这周的工作中,有一部分就是改文档的工作。虽说各种文档的格式或模板不是一成不变的,但是,在老师的要求下会是我们的文档较之前更加严谨,写文档的能力得到一定的提高。

      软件过程中,文档本来就是产品的一部分。而且文档经常被作为里程碑标记,使项目跟踪和控制变得可能,也使软件生产的每一部分都可前溯,保证软件的质量。所以我们组都会认真对待所写的每一份文档。正如老师在上课的时候提到流程图的画法时,说到我们之前的基本都画错,因此对于每次有画图的部分,我们都会认真查找资料后再着手画,保证速度的同时一定保证质量。就这样,仅仅是通过写文档,我们又可以对之前学过的知识进行巩固一下。

      对于各种文档,据我在网上的了解,软件开发人员不愿意写文档,我想这主要指的是刚参加工作时间不长的工作人员。大体的原因应该有:

      (1)软件开发的大环境不好。(2)重技巧的学习,而轻视能力的培养,我国的软件开发人员重视对技巧的学习。(3)重视表面的东西,轻视基础,说到的基础就如:数据流图,数据库设计中的1NF,2NF,3NF,BCNF。(4)对系统不了解,是写不好文档的最主要的原因。调研人员对客户的流程并没有作到真实的了解。同时为了避免被别人发现问题,最好的方法当然是不写文档,避免暴露自己的不足。(5)不会讲问题分层次,复杂问题讲不清楚,是开发人员不写文档的另外一个原因。简单一点就是没有学会处理问题的方法,不会将复杂问题分层次,不会将问题分解为简单问题,逐个处理。(6)糟糕的写作功底,是不写文档的一个原因。我们是学理工,文字功力差一点没有关系,这是很多软件人员的说法。(7)最后一个原因,这是一个很实在有很尴尬的现实,很多人没有进行过正规的开发,甚至没有见过真正‘好’的技术文档,自然就不能感受好文档的作用,于是认为现在这种糟糕的文档就是最好的,而这些文档对开发没有任何作用(反而耽误时间),自然就不愿意在写文档了。

  • 相关阅读:
    HTB-靶机-Charon
    第一篇Active Directory疑难解答概述(1)
    Outlook Web App 客户端超时设置
    【Troubleshooting Case】Exchange Server 组件状态应用排错?
    【Troubleshooting Case】Unable to delete Exchange database?
    Exchange Server 2007的即将生命周期,您的计划是?
    "the hypervisor is not running" 故障
    Exchange 2016 体系结构
    USB PE
    10 months then free? 10个月,然后自由
  • 原文地址:https://www.cnblogs.com/LH956574963/p/5399731.html
Copyright © 2011-2022 走看看