内容提纲:(1)软件工程各类开发文档的目的与作用详解

(2)操作手册与用户手册的区别。

一、《可行性研究报告》

可行性研究报告是在制定研发项目之前,以全面、系统的分析为主要方法,经济效益为核心,对本项目实施的可能性、有效性、技术方案及技术政策进行具体、深入、细致的技术论证和经济评价,以求确定一个在技术上合理、经济上合算的最优方案和最佳时机。分析项目是否具备开发的必要性与可行性。

可行性研究报告的预期读者为系统管理人员、开发与运维人员。

简而言之,就是分析可行性,确定最优方案。

二、《项目开发计划书》

项目开发计划的作用就是用文件的形式,根据可行性研究推荐的可行方案,落实各项工作的负责人、参加人员(系统分析员、系统设计员、程序员、资料员等)以及各种资源(计算机硬件、软件工具等)的需求,制定项目开发进度、验收标准和成本概算等,以文件形式记载下来,指导整个项目开发工作的顺利进行,并为开发的下一步做准备。

预期读者是系统分析员和开发人员。

通俗些讲,就是根据可行性研究出来的最优方案,把工作内容分配下去。

三、《软件需求说明书》

软件需求说明书是需求分析阶段的一个文档,是对软件目标及范围的求精和细化,深入描述软件的功能和性能以及软件的约束范围,使用户和软件开发者对该软件的初始规定有个大概了解,便于用户、开发人员进行理解和交流。明确了开发软件的方向,程序员要根椐需求规格说明书去开发软件, 作为确认测试和验收的依据,有利于对项目的回溯和指导后续的开发和维护。

文档读者:开发人员与用户代表。

这个就是搞需求的,开发计划书里已经计划好了你搞测试,我搞开发,他弄管理,好,那咱们开工吧,开工之前先搞清需求是啥,弄一个物理模型出来,就是系统应该是怎么样的,这就是需求说明书。

四、《概要设计说明书》

概要设计说明书是在用户的需求分析阶段的基础上,对系统做概要设计,为在需求分析阶段得到的目标系统的物理模型确定一个合理的软件系统的体系结构。包括合理地划分组成系统的模块、模块间的调用关系及模块间的接口,并且为软件系统提供所用的数据结构或者数据库结构。从而为下一阶段的详细设计做参考,设计阶段将以本文档为核心文档。

本文档的读者是项目设计和项目编码人员。

概要设计说明书阶段已经规定了系统内、外部接口,并设计好数据库。

五、《详细设计说明书》

详细设计说明书是在概要设计的基础上进一步明确系统结构,表示出软件结构的图表,完成算法设计、数据结构设计、物理设计等,详细地描述的逐个模块,包括算法和逻辑流程的具体实现方法,设计系统的物理模型等,为下一步系统的实现和测试做准备。开发人员在完成概要设计说明书的基础上,在编码阶段可以把这个描述直接翻译成用某种程序设计语言书写的程序。详细设计的结果基本上决定了最终程序代码的质量。详细设计的目标不仅仅是在逻辑上正确的实现每个模块的功能,更重要的是设计出的处理过程应该尽可能简明易懂。

编写详细设计说明说的目的就是为程序员写出实际的程序代码提供依据。它是软件详细设计阶段所有任务和所有相关人员(包括项目管理人员、软件设计人员、软件测试人员、文档编制人员和质量审核人员),所需要的参考资料。

本文档的预期读者是程序开发人员、程序测试人员与客户。

详细设计说明书对系统描述的细致程度已经到了顶级了,所以有些人也形象的把详细设计说明书的作用比喻成”后期需求方和开发方打嘴仗时的一个凭证“。详细设计说明书一般是对大型系统准备的,如果是小系统的话,概要设计说明书就够用了,详细设计说明书可以省略。

六(1)、《数据库设计说明书》

数据库设计说明书描述了机房收费系统数据库的设计,提供了数据库设计的可视性以及软件支持所需的信息,应用于系统开发前期,为了让参与本项目的项目的人员了解本系统的数据库设计思路、数据库整体架构及各种详细信息,也为了以后的各个项目可以参与借鉴该项目的经验,将数据分析的结果进一步整理,对本系统数据库的所有标识、逻辑结构和物理结构作用作出具体的设计规定和分析说明,形成最终的计算机模型,以便开发人员建立物理数据库。

预期读者为数据库设计师、数据库管理员。

这一阶段是确定数据库的逻辑结构和物理结构。

六(2)、《数据要求说明书》

编写数据库要求说明书的目的是明确系统中各项功能和非功能性需求实现时所需要的数据,根据此数据设计数据库。同时为概要设计和详细设计人员提供设计依据,其他本项目组的开发人员也可以参阅。定义总体要求,作为用户和软件开发人员之间相互了解的基础;提供性能要求、初步设计和对用户影响的信息,作为开发人员进行设计和实施的基础;作为总体验证和确认的依据。

本文档的阅读对象为:数据库设计人员、系统测试人员

这一阶段进一步确定了数据库中的数据要求。

七、《测试计划说明书》

制定该测试计划书主要为了能够对开发过程中的部分环节进行有序、高效地测试,最终可最大限度地发现软件中的错误,并减少软件中残留的错误。描述了需要测试的特性、测试的方法、测试环境的规划、测试用例的设计方法、明确测试策略、明确谁来完成每项任务以及需要制定应急方案的所有风险等。通过测试,验证该机房管理系统系统模型已经达到设计的标准,交由项目负责人审阅并总结测试活动的成功经验与不足,以便今后更好地开展测试工作。

本文档的预期读者是系统编程人员和系统测试人员。

这一阶段是确定如何对系统进行测试的。

八、《测试分析报告》

测试分析报告是在测试的基础上,对测试的结果以及测试的数据等写成文档,对发现的问题和缺陷加以记录和分析总结,为纠正软件的存在的质量问题提供依据,同时为软件验收和交付打下基础。另外,它还有利于今后软件开发者阅读源程序,根据测试提供的数据和结果,分析源代码,掌握各函数的功能和局限性,从而缩短软件开发者的在开发时间和所耗费的精力、资金。

本文档的预期读者是软件开发人员。

九、《项目开发总结报告》

系统的开发工作已经基本完成。写此项目开发总结报告,以方便我们在以后的项目开发中来更好的实施项目的制定开发,让我们在今后的项目开发中有更多的资料来规范我们的开发过程和提高我们的开发效率,从而创造更多公司效益。

预期读者为相关软件的开发人员。

对项目开发的总结。

十、《操作手册》

操作手册的目的在于告诉系统的使用者,系统提供了那些功能,以及如何正确地、有效地来使用这些功能。

预期读者是系统用户。

十一、《用户手册》

编写此文档的主要目的是为了给使用者提供一个使用指南,以便为首次使用该系统的用户说明使用方法,以及给已经使用过或者正在使用的用户在使用过程中遇到问题时提供解决问题的方法。

预期读者为系统用户。

附:操作手册和用户手册的区别:

操作手册是系统级别的文档,而用户手册是需求级别的文档,一个针对操作,一个针对功能详解,操作手册是想得到什么界面,如何操作,而用户手册,你要介绍为什么要有这些操作,经过这些操作,得到的结果界面是干什么用的。如果说包含关系,用户手册是包括操作手册的。

十二、《开发进度月报》

开发进度月报的编制目的是及时向有关管理部门汇报项目开发的进展和情况,以便及时发现或处理开发过程中出现的问题。一般开发进度月报是以项目组为单位每月编写的。如果被开发的软件系统规模比较大,整个工程项目被划分给若干个分项目组承担,开发进度月报将以项目组为单位按月编写。

预期读者为项目管理员。

总结:软件开发文档都是有时间顺序、操作流程顺序联系的,编写文档前首先要了解各文档的作用,有备无患。

1

软件工程各类开发文档的作用相关推荐

  1. 软件开发文档的价值和作用

    现代软件研发理念强调敏捷开发,快速迭代,高效地响应用户的需求变化.可以说,自从有了敏捷方法,有相当一部分程序员长出一口气:终于可以不用写文档了. 那么,事实真的如此吗,文档应不应该写,应该如何编写? ...

  2. 软件工程开发文档写作教程(05)—可行性研究报告写作规范

    本文原创作者:谷哥的小弟 作者博客地址:http://blog.csdn.net/lfdfhl 本文参考资料:电子工业出版社<软件文档写作教程> 马平,黄冬梅编著 软件工程开发文档现状 一 ...

  3. 软件开发中常见英文缩写和各类软件开发文档的英文缩写

    软件开发中常见英文缩写和各类软件开发文档的英文缩写: 文章复制粘贴来源于:http://blog.sina.com.cn/s/blog_7326867a0100yfdl.html 英文简写 文档名称 ...

  4. 记一次后端接口开发文档的组织过程(elasticsearch)

    前言:   沟通是有成本的,尤其是项目成员技术差距很大的时候,良好的代码编写必须是以文档驱动的,这是领悟软件工程精髓的必经之路.   记一次小组开发文档的组织,虽然我本人组织得不伦不类,但是也必须得给 ...

  5. 【IT基础】常见的开发文档

    Perface 随着技术的进步,小作坊式的软件开发年代已经过去.目前的软件开发能力在不断提升,用户对软件的功能和性能要求也越来越高,软件开发质量受到关注. 在软件开发过程中,各种数据和代码的管理需要经 ...

  6. 开发文档之 概要设计说明书 详细设计说明书 数据库设计说明书

      软件工程是一门技术含量高设计极其复杂的学科.为了控制好软件产品质量和规范,就必须用大量的文档约束软件工程的进度和状态.浩大的软件工程对于缺少工作和项目经验的人来说,必然是摸不着头脑不知从何开始.[ ...

  7. Android 界面滑动实现---Scroller类 从源码和开发文档中学习(让你的布局动起来)...

    在android学习中,动作交互是软件中重要的一部分,其中的Scroller就是提供了拖动效果的类,在网上,比如说一些Launcher实现滑屏都可以通过这个类去实现..   例子相关博文:Androi ...

  8. 软件开发文档整理(之)一张示意图 | 清晰明了

      在整个软件开发周期,开发文档是必不可少的资料,它们贯穿于整个开发周期,用来评估计划.规划进度.项目管理.软件测试.软件发布,可以说至关重要.   开发文档必须归档,没有归档的文档作用大打折扣,时效 ...

  9. .NET6使用DOCFX根据注释自动生成开发文档

    本文内容来自我写的开源电子书<WoW C#>,现在正在编写中,可以去WOW-Csharp/学习路径总结.md at master · sogeisetsu/WOW-Csharp (gith ...

最新文章

  1. 如何在python中显示电脑中的图片-python在终端里面显示一张图片
  2. 使用 jQuery 查询属性不包含 disabled 的 input radio
  3. 计算机教师职称申报工作总结,个人评定一级教师工作总结
  4. php中ci框架分页,Codeigniter(CI)框架分页函数及相关知识
  5. python selenium框架搭建_python + selenium 自动化框架搭建
  6. 小程序源码:微信智慧外链接致富版微信小程序源码下载,支持多端转换-多玩法安装简单
  7. tera term串口文本匹配打印时间脚本
  8. 【bug解决】上传图片后,取消这次上传 再次执行上传,上次的图片还存在
  9. 图片格式转换器ico_格式工厂万能格式转换器
  10. 良心推荐:最适合玩吃鸡手游的安卓机型有哪些?刺激战场为例
  11. 直接在浏览器运行Python代码
  12. Microsoft Visual C++ 14.0 or greater is required. Get it with “Microsoft C++ Build Tools“(已解决)
  13. 编写优质嵌入式C程序(转)
  14. kerberos 之TGS_REQ、TGS_REP
  15. 线性分类(四)-- 高斯判别分析 GDA
  16. P4117 [Ynoi2018] 五彩斑斓的世界
  17. 解决频繁自动弹出“QQ拼音升级程序”,可使用旧版QQ输入法
  18. 如何实现与Teamcenter PLM单点登录(SSO)
  19. 织梦滚石v3.0导航网站源码+测试版
  20. 微信dat文件用什么软件打开方式_dat文件用什么软件打开?

热门文章

  1. 早晨看到的七彩云,据说是祥瑞
  2. 广东政务微信的服务器设置,广东又一省级政务微信号上线!
  3. 个人博客系统开发总结之 mybatis操作blob字段
  4. 用java编程的单片机_单片机可以用java编程或经过技术手段来可以用java编程吗?...
  5. Nginx服务器初步应用和说明
  6. 【源码分享】-c#界面源代码分享
  7. redis操作五种数据的命令说明
  8. Autosizer应用程序窗口控制工具
  9. 实验5 使用三层交换机划分VLAN及VLAN互通
  10. FCU1104 专为物联网边缘计算网关而生