第七周作业-谈谈各种文档

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

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

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

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

时间: 2024-10-17 07:55:26

第七周作业-谈谈各种文档的相关文章

2017-2018-2 1723《程序设计与数据结构》第七周作业 总结

作业地址 第七周作业:https://edu.cnblogs.com/campus/besti/CS-IMIS-1723/homework/1806 (本周博客直接在作业界面打了分,可供随时查看) 提交情况如图:(严域俊这次忘交,请下次注意) 作业要求 教材第9章 (1)阅读9.1-9.5章节 (2)代码托管到[email protected],参考一下使用开源中国托管代码 (3)完成课后自测题,并参考答案学习 (4)完成课后练习题 (5)完成程序设计项目:至少完成PP9.1.PP9.3. (6

团队作业:SRS文档-飞机大战

本实验为团队合作项目作业的一部分:SRS文档-飞机大战 项目分工:SRS文档项目为梁健明负责完成 实验要求: 3.SRS文档(第二周,截止5月31日)              要求对所选项目进行用例建模 设计使用工具 :IBM Rational Rose Enterprise Edition 业务流程分析图 系统总体设计 系统的中只有玩家一种用户,玩家点击应用图标直接进入应用的开始界面.用户的操作总体可以归并成玩家用例图所显示的内容,子弹的用例图,飞机的用例图. 用户的操作基本可以划分为“开始

软件项目与过程管理第七周作业

问题:关于文档修订方面内容的总结及本次项目中所编写的文档的重要性说明. 一.立项说明书 1.立项说明书能详细地说明项目的可交付成果和为提交这些可交付成果而必须开展的工作. 2.立项说明书是项目利害关系者对项目范围的共同理解,说明了项目的主要目标. 3.立项说明书能够使项目团队能够实施更详细的规划,在执行过程中指导项目团队的工作,并构成评价变更请求或增加的工作是否超出项目边界的基准. 4.立项说明书能够明确提出了哪些工作要做,哪些工作不要做,以及要做的水平,这决定了项目管理团队控制整个项目范围的好

第七周作业_2013551605

一.关于html5 html5出现意图: web浏览器之间的兼容性很低,文档结构不够明确,web应用程序的功能收到了限制 1.html5新特性 用于绘画的canvas标签: 用于媒介回放的video和audio元素: 对本地离线储存的更好支持: 新的特殊内容元素:如:article.footer.header.nav.section 新的表单控件:如:calendar.date.time.email.url.search html5与html4的区别: 1.语法的改变: (1)DOCTYPE声明

C语言--第七周作业评分(5班)

作业链接:https://edu.cnblogs.com/campus/hljkj/CS2017-5/homework/1304 一.评分要求 要求1 完成PTA第七周所有题,总共两次题,每次12.5分.若存在抄袭现象,倒扣此题所有分数(25分). 要求2 2道题,每道题对应10分(总计20分). (1)实验代码(1分). (2)设计思路:算法描述(1分),流程图(2分). (3)调试过程中遇到的问题及解决办法(3分). (4)本题PTA提交列表(3分). 要求3 按照要求2将其他题目的代码.解

网络攻防第七周作业

教材第七章总结 01 知识要点总结 windows系统的基本架构 1.windows系统的发展与现状 2.windows系统的基本结构 windows系统的安全体系结构与机制 1.windows系统的安全体系结构概述 2.windows认证机制 3.windows系统访问与授权机制 4.windows系统安全审计机制 5.windows系统的其他安全机制 windows系统安全攻防技术 1.windows系统的安全漏洞 2.windows远程口令猜解 3.windows服务远程 4.手动实践:M

《结对编项目作业名称-设计文档》

项目:关灯游戏,所用软件,pygame 成员:祁昊,刘孝东 关灯游戏设计文档: pygame作为一种游戏编程语言,以其简单性.可移植性等优点,得到了广泛地应用,特别是py使用比c,c++等语言简便,使其成为网络编程首选编程语言.,Pygame是跨平台Python模块,专为电子游戏设计.基于这样一个设想,所有需要的游戏功能和理念都(主要是图像方面)都完全简化为游戏逻辑本身,所有的资源结构都可以由高级语言提供,如Python.工具tile编辑器和一个关卡编辑器.得到广大程序员的接受和认可. "关灯游

第七周作业 暂时提交明早再改改xml问题

XML 的重要领域,比如 DTD, XML Schema, XSLT 转换, XPATH 检索, XML 绑定, XML 解析器以及 XML 的基本知识,比如命名空间,校验,属性,元素等.1: XML 是什么?    XML 即可扩展标记语言( Extensible Markup language),你可以根据自己的需要扩展 XML.XML 中可以轻松定义<books>, <orders>等自定义标签,而在 HTML 等其他标记语言中必须使用预定义的标签,比如<p>,而

第七周作业 项目开发过程的感想问题

临近项目开发结尾的时候了,我们的工作也变得越发繁忙和紧张了起来,大家都被分配了各种各样的任务, 之前学过的HTML,CSS,JAVASCRIPT,Jquery等知识都能得到运用充分的运用. 虽说是大家一起通力合作完成项目组的开发,但每人都被分配了不同的任务,像我,就是把主页中 分好的块中添加 该有的表格, 图片, 文字.之前还出了一点小问题,我之前也是负责前台的网页设计,我们的project manager推荐我 使用便捷的原型设计工具软件--justinmind,我接手了之后倒算是得心应手,也