软件文档基础知识概述
相关主题
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
软件文档基础知识Βιβλιοθήκη Baidu述
路漫漫其悠远
少壮不努力，老大徒悲伤
教材
教材：软件编档导论 清华大学出版社 金波编著
参考资料： 计算机软件工程标准(文档部分GB/T8567-1988、GB/T9385-1988) 国家标准汇编 中国标准出版社
课程学时分配和评分标准
课时分配：每周2+2，共8周+1周 最后一周考试(考查) 课后作业仅供参考
软件文档的编制是随着软件生存期各个阶段工作的开展而适时进行的。 其中，有的仅反映某一阶段的工作，有的则需要跨越多个阶段的工作。
可行性研究报告 项目开发计划 软件需求说明书 数据要求说明书 测试计划 概要设计说明书 详细设计说明书 数据库设计说明书 模块开发卷宗 用户手册 操作手册 测试分析报告 开发进度月报 项目总结报告 维护和修改建议
可行性研究与计划 √ √
需求分析
√ √ √ √
√
√
√
软件设计 编码与单元测试 集成与测试 运行与维护
√
√
√
√
√
√
√
√
√
√
√
√
√ √ √
√
软件文档最终需要回答读者关心的下列问题： 1. 为什么要开发、维护或修改这个软件？(Why) 2. 工作目标要满足哪些需求？(What) 3. 需求应如何实现？(How) 4. 开发、维护或修改的工作应由谁来完成？(Who) 5. 开发工作的时间如何安排？(When) 6. 开发工作在什么环境中实现，所需信息从何而来？(Where)
可通过e-mail递交，不限时，不记分 考试方法：开卷 评分标准：期末考试(60%)＋课程设计(40%)
＝总评 100%
软件文档写作课程设计项目
Home Design and Improvement System
课程设计项目是若干模拟情景题目。 要求：每组不超过6人，设组长一名； 组长负责：组织、分工、安排进度等； 组长奖罚：引起过半数组员不满者，改选；带领全组 顺利完成任务者，总评+5。 目的：通过课程设计，实际体验软件工程各阶段的主 要工作，特别注意吸取教训；学会与他人合作，培养 团队精神。因此，单干户将得不到成绩。
计算机软件
用户
维护人员
开发人员
管理人员 桥梁作用
1.3 文档的作用
软件文档在产品开发过程中具有十分重要的桥梁作用，主要 反映在以下几个方面：
1. 项目管理的依据
文档将通常“不可见的”软件开发进程转换成“可见的”文 字资料，有利于项目的管理。
2. 技术交流的语言
项目小组内部、项目平行开发的各小组之间进行的交流和联 系，通常都是通过文档来实现的。
软件文档作为“记载软件历史的语言”，可用作未来项目的 一种资源，向潜在用户报道软件的各种有利信息，便于他们判 断自己是否需要该软件提供的服务。
良好的系统文档，显然有助于完成软件的移植，或将软件转 移到各种新的系统环境中去。
1.4 软件文档的分类
国家标准局在1988年1 月颁布了《计算机软件开 发规范》和《计算机软件 产品开发文件编制指南》， 作为软件开发和文档编制 工作的准则和规程。
3. 项目质量保证
文档是进行项目质量审查和评价的重要依据，有效文档的提 供，可以满足项目质量保证人员和审查人员的工作需要。
4. 支持培训与维护 合格的软件文档通常都提供有关软件运行、维护和培训的必
要信息，支持软件产品的应用和维护。 5. 支持软件维护
软件文档提供系统开发的全部必要技术资料，有利于维护人 员熟悉系统，开展维护工作；软件维护文档记载了软件维护过 程中软件及其环境变化的全部信息。 6. 记载软件历史
软件文档是一种重要的软件工程技术资料。如系统分析文档、 设计文档、版本说明文档……
软件文档的规范编制，在软件开发工作中占有突出的地位和 相当大的工作量。高质量、高效率的编制、分发、管理、维护 文档，及时的变更、修正、扩充和使用文档，对于软件产品的 设计开发、发行使用、变更维护、转让移植、二次开发等，对 于充分发挥软件产品的效益，都有着重要的意义。
可行性研究报告 项目开发计划 软件需求说明书 数据要求说明书 概要设计说明书 详细设计说明书 数据库设计说明书 测试计划 测试分析报告
设计说明书 测试分析报告 模块开发卷宗
可行性研究报告 项目开发计划 模块开发卷宗 开发进度月报 项目开发总结报告
用户手册 操作手册
1.6 软件文档编制与软件生存期的关系
工作内容
⑴ 问题定义
（书面）
⑵ 可行性分析报告 （书面）
⑶ 项目开发计划
（书面）
⑷ 需求规格说明书 （书面）
⑸ 总体设计报告 （书面）
⑹ 系统测试计划
（书面）
⑺ 项目验收方案
（书面）
要求：根据软件工程技术和项目管理理念，在
组内合理分工，协同工作。
第一章 软件文档概念
1.1 为什么需要软件文档？
文档是计算机软件产品的重要组成部分，没有文档就不成其 为软件，也更不能成为软件产品。
观点：“如果不记下来，它就并不存在”。 正如老子在《道德经》中所述：鱼不可脱于渊，国之利器不可 以示人。
1.2 软件文档的定义
软件文档写作是为了记录目标系统的定义、规划、分析、研究、设计、开 发、应用等各个阶段的设计思想和研究成果。
文档——某种数据媒体和其中所记录的数据。 文档具有永久性，并可供人或机器阅读，通常指专供人阅读的东西。 文档作为计算机软件的重要组成部分，告诉用户如何操作和维护系统，提 供关于未来改进和重新实施所需的信息，在开发人员、维护人员、管理人员、 用户与计算机之间起着重要的桥梁作用。
用户手册 操作手册 软件需求说明书 数据要求说明书
项目开发计划 模块开发卷宗 开发进度月报 测试计划 测试分析报告 项目开发总结报告
1.5 软件文档与使用者的关系 软件开发中产生的各类文档
面向不同的用户，而软件用户 应该得到的文档也在商业合同 中有明确规定。
软件文档的使用对象
开发人员
维护人员 管理人员 用户
基于软件生存期方法， 可以从形式上将软件文档 大致分成两类：软件开发 过程中需要填写的各种图 表，及应编制的各种技术 文件或管理资料。
软件文档
软件文档根据其产生和 使用的范围，主要划分为 3大类：开发文档、用户 文档和管理文档。
开发文档 用户文档 管理文档
可行性研究报告 项目开发计划 软件需求说明书 数据库设计说明书 概要设计说明书 详细设计说明书
路漫漫其悠远
少壮不努力，老大徒悲伤
教材
教材：软件编档导论 清华大学出版社 金波编著
参考资料： 计算机软件工程标准(文档部分GB/T8567-1988、GB/T9385-1988) 国家标准汇编 中国标准出版社
课程学时分配和评分标准
课时分配：每周2+2，共8周+1周 最后一周考试(考查) 课后作业仅供参考
软件文档的编制是随着软件生存期各个阶段工作的开展而适时进行的。 其中，有的仅反映某一阶段的工作，有的则需要跨越多个阶段的工作。
可行性研究报告 项目开发计划 软件需求说明书 数据要求说明书 测试计划 概要设计说明书 详细设计说明书 数据库设计说明书 模块开发卷宗 用户手册 操作手册 测试分析报告 开发进度月报 项目总结报告 维护和修改建议
可行性研究与计划 √ √
需求分析
√ √ √ √
√
√
√
软件设计 编码与单元测试 集成与测试 运行与维护
√
√
√
√
√
√
√
√
√
√
√
√
√ √ √
√
软件文档最终需要回答读者关心的下列问题： 1. 为什么要开发、维护或修改这个软件？(Why) 2. 工作目标要满足哪些需求？(What) 3. 需求应如何实现？(How) 4. 开发、维护或修改的工作应由谁来完成？(Who) 5. 开发工作的时间如何安排？(When) 6. 开发工作在什么环境中实现，所需信息从何而来？(Where)
可通过e-mail递交，不限时，不记分 考试方法：开卷 评分标准：期末考试(60%)＋课程设计(40%)
＝总评 100%
软件文档写作课程设计项目
Home Design and Improvement System
课程设计项目是若干模拟情景题目。 要求：每组不超过6人，设组长一名； 组长负责：组织、分工、安排进度等； 组长奖罚：引起过半数组员不满者，改选；带领全组 顺利完成任务者，总评+5。 目的：通过课程设计，实际体验软件工程各阶段的主 要工作，特别注意吸取教训；学会与他人合作，培养 团队精神。因此，单干户将得不到成绩。
计算机软件
用户
维护人员
开发人员
管理人员 桥梁作用
1.3 文档的作用
软件文档在产品开发过程中具有十分重要的桥梁作用，主要 反映在以下几个方面：
1. 项目管理的依据
文档将通常“不可见的”软件开发进程转换成“可见的”文 字资料，有利于项目的管理。
2. 技术交流的语言
项目小组内部、项目平行开发的各小组之间进行的交流和联 系，通常都是通过文档来实现的。
软件文档作为“记载软件历史的语言”，可用作未来项目的 一种资源，向潜在用户报道软件的各种有利信息，便于他们判 断自己是否需要该软件提供的服务。
良好的系统文档，显然有助于完成软件的移植，或将软件转 移到各种新的系统环境中去。
1.4 软件文档的分类
国家标准局在1988年1 月颁布了《计算机软件开 发规范》和《计算机软件 产品开发文件编制指南》， 作为软件开发和文档编制 工作的准则和规程。
3. 项目质量保证
文档是进行项目质量审查和评价的重要依据，有效文档的提 供，可以满足项目质量保证人员和审查人员的工作需要。
4. 支持培训与维护 合格的软件文档通常都提供有关软件运行、维护和培训的必
要信息，支持软件产品的应用和维护。 5. 支持软件维护
软件文档提供系统开发的全部必要技术资料，有利于维护人 员熟悉系统，开展维护工作；软件维护文档记载了软件维护过 程中软件及其环境变化的全部信息。 6. 记载软件历史
软件文档是一种重要的软件工程技术资料。如系统分析文档、 设计文档、版本说明文档……
软件文档的规范编制，在软件开发工作中占有突出的地位和 相当大的工作量。高质量、高效率的编制、分发、管理、维护 文档，及时的变更、修正、扩充和使用文档，对于软件产品的 设计开发、发行使用、变更维护、转让移植、二次开发等，对 于充分发挥软件产品的效益，都有着重要的意义。
可行性研究报告 项目开发计划 软件需求说明书 数据要求说明书 概要设计说明书 详细设计说明书 数据库设计说明书 测试计划 测试分析报告
设计说明书 测试分析报告 模块开发卷宗
可行性研究报告 项目开发计划 模块开发卷宗 开发进度月报 项目开发总结报告
用户手册 操作手册
1.6 软件文档编制与软件生存期的关系
工作内容
⑴ 问题定义
（书面）
⑵ 可行性分析报告 （书面）
⑶ 项目开发计划
（书面）
⑷ 需求规格说明书 （书面）
⑸ 总体设计报告 （书面）
⑹ 系统测试计划
（书面）
⑺ 项目验收方案
（书面）
要求：根据软件工程技术和项目管理理念，在
组内合理分工，协同工作。
第一章 软件文档概念
1.1 为什么需要软件文档？
文档是计算机软件产品的重要组成部分，没有文档就不成其 为软件，也更不能成为软件产品。
观点：“如果不记下来，它就并不存在”。 正如老子在《道德经》中所述：鱼不可脱于渊，国之利器不可 以示人。
1.2 软件文档的定义
软件文档写作是为了记录目标系统的定义、规划、分析、研究、设计、开 发、应用等各个阶段的设计思想和研究成果。
文档——某种数据媒体和其中所记录的数据。 文档具有永久性，并可供人或机器阅读，通常指专供人阅读的东西。 文档作为计算机软件的重要组成部分，告诉用户如何操作和维护系统，提 供关于未来改进和重新实施所需的信息，在开发人员、维护人员、管理人员、 用户与计算机之间起着重要的桥梁作用。
用户手册 操作手册 软件需求说明书 数据要求说明书
项目开发计划 模块开发卷宗 开发进度月报 测试计划 测试分析报告 项目开发总结报告
1.5 软件文档与使用者的关系 软件开发中产生的各类文档
面向不同的用户，而软件用户 应该得到的文档也在商业合同 中有明确规定。
软件文档的使用对象
开发人员
维护人员 管理人员 用户
基于软件生存期方法， 可以从形式上将软件文档 大致分成两类：软件开发 过程中需要填写的各种图 表，及应编制的各种技术 文件或管理资料。
软件文档
软件文档根据其产生和 使用的范围，主要划分为 3大类：开发文档、用户 文档和管理文档。
开发文档 用户文档 管理文档
可行性研究报告 项目开发计划 软件需求说明书 数据库设计说明书 概要设计说明书 详细设计说明书