软件写作01 概述概要课件

2022/11/12软件文档写作实训任课老师：冯茂岩

信息工程学院

2022/11/12软件文档写作实训任课老师：冯茂岩2022/11/122参考资料参考资料

《软件编档导论》 清华大学出版社金波编著

《软件文档写作教程》

电子工业出版社马平等编著

计算机软件工程标准

(文档部分GB/T8567-1988、GB/T9385-1988) 国家标准汇编中国标准出版社2022/11/122参考资料参考资料2022/11/123课程学时分配和评分标准课时分配：30学时考核标准：出勤（20%）+平时成绩（30%)+综合报告(50%)

＝总评（100%）2022/11/123课程学时分配和评分标准2022/11/124了解软件文档在软件开发过程中的作用、地位以及文档编制的有关标准；理解软件文档与软件生存周期的关系，掌握软件文档的分类；熟悉软件文档的编写方法，了解常用的文档编制工具软件；能够根据标准模板编写可行性研究报告、需求分析说明书、概要设计文档、详细设计文档、用户文档和管理文档等；熟悉毕业论文的撰写和编排。教学目标2022/11/124了解软件文档在软件开发过程中的作用、地2022/11/12软件文档写作课程实践要求实践项目：若干模拟题目要求：每组不超过6人，设组长一名组长负责：组织、分工、安排进度等组长奖罚：引起过半数组员不满者，改选；带领全组顺利完成任务者，总评+5目的：通过课程实践，实际体验软件工程各阶段的主要工作；学会与他人合作，培养团队精神；培养软件文档的写作能力，为毕业设计及论文的撰写打下基础52022/11/12软件文档写作课程实践要求52022/11/126实践内容(1)问题定义 （书面、电子）（选做）(2)可行性分析报告 （书面、电子）（必做）朱(3)项目开发计划 （书面、电子）（必做）韩(4)需求规格说明书 （书面、电子）（必做）曹晓雯(5)总体设计报告 （书面、电子）（必做）谢(6)系统测试计划 （书面、电子）（选做）(7)用户操作手册 （书面、电子）（必做）高帅(8)模拟毕业论文 （书面、电子）（必做）李要求：根据软件工程技术和项目管理理念，在组内合

理分工，协同工作。2022/11/126实践内容2022/11/127问:什么是软件?软件=程序+文档2022/11/127问:什么是软件?软件=程序+文档2022/11/128第一讲软件文档概念2022/11/128第一讲软件文档概念2022/11/129

1.1为什么需要软件文档？

文档是计算机软件产品的重要组成部分，没有文档就不成其为软件，也更不能成为软件产品。软件文档是一种重要的软件工程技术资料。如系统分析文档、设计文档、版本说明文档……

软件文档的规范编制，在软件开发工作中占有突出的地位和相当大的工作量。高质量、高效率的编制、分发、管理、维护文档，及时的变更、修正、扩充和使用文档，对于软件产品的设计开发、发行使用、变更维护、转让移植、二次开发等，对于充分发挥软件产品的效益，都有着重要的意义。2022/11/1291.1为什么需要软件文档？2022/11/12101.2软件文档的定义

软件文档写作是为了记录目标系统的定义、规划、分析、研究、设计、开发、应用等各个阶段的设计思想和研究成果。

文档——某种数据媒体和其中所记录的数据。

文档具有永久性，并可供人或机器阅读，通常指专供人阅读的东西。文档作为计算机软件的重要组成部分，告诉用户如何操作和维护系统，提供关于未来改进和重新实施所需的信息，在开发人员、维护人员、管理人员、用户与计算机之间起着重要的桥梁作用。计算机软件用户桥梁作用2022/11/12101.2软件文档的定义计算机软件用2022/11/12111.3文档的作用

软件文档在产品开发过程中具有十分重要的桥梁作用，主要反映在以下几个方面：项目管理的依据

文档将通常“不可见的”软件开发进程转换成“可见的”文字资料，有利于项目的管理。技术交流的语言

项目小组内部、项目平行开发的各小组之间进行的交流和联系，通常都是通过文档来实现的。项目质量保证

文档是进行项目质量审查和评价的重要依据，有效文档的提供，可以满足项目质量保证人员和审查人员的工作需要。2022/11/12111.3文档的作用2022/11/1212支持培训与维护

合格的软件文档通常都提供有关软件运行、维护和培训的必要信息，支持软件产品的应用。支持软件维护

软件文档提供系统开发的全部必要技术资料，有利于维护人员熟悉系统，开展维护工作；软件维护文档记载了软件维护过程中软件及其环境变化的全部信息。记载软件历史

软件文档作为“记载软件历史的语言”，可用作未来项目的一种资源，向潜在用户报道软件的各种有利信息，便于他们判断自己是否需要该软件提供的服务。良好的系统文档，显然有助于完成软件的移植，或将软件转移到各种新的系统环境中去。2022/11/1212支持培训与维护2022/11/12131.4软件文档的分类

国家标准局在1988年1月颁布了《计算机软件开发规范》和《计算机软件产品开发文件编制指南》，作为软件开发和文档编制工作的准则和规程。基于软件生存期方法，可以从形式上将软件文档大致分成两类：软件开发过程中需要填写的各种图表，及应编制的各种技术文件或管理资料。软件文档根据其产生和使用的范围，主要划分为3大类：开发文档、用户文档和管理文档。软件文档开发文档用户文档管理文档可行性研究报告项目开发计划软件需求说明书数据库设计说明书概要设计说明书详细设计说明书用户手册操作手册软件需求说明书数据要求说明书项目开发计划模块开发卷宗开发进度月报测试计划测试分析报告项目开发总结报告2022/11/12131.4软件文档的分类软件文档开发文2022/11/12141.5软件文档与使用者的关系

软件开发中产生的各类文档面向不同的用户，而软件用户应该得到的文档也在商业合同中有明确规定。软件文档的使用对象开发人员维护人员管理人员用户可行性研究报告项目开发计划软件需求说明书数据要求说明书概要设计说明书详细设计说明书数据库设计说明书测试计划测试分析报告设计说明书测试分析报告模块开发卷宗可行性研究报告项目开发计划模块开发卷宗开发进度月报项目开发总结报告用户手册操作手册2022/11/12141.5软件文档与使用者的关系软件文2022/11/12可行性研究与计划需求分析软件设计编码与单元测试集成与测试运行与维护可行性研究报告√项目开发计划√√软件需求说明书√数据要求说明书√测试计划√√概要设计说明书√详细设计说明书√数据库设计说明书√模块开发卷宗√√用户手册√√√操作手册√√测试分析报告√开发进度月报√√√√√项目总结报告√维护和修改建议√151.6软件文档编制与软件生存期的关系

软件文档的编制是随着软件生存期各个阶段工作的开展而适时进行的。其中，有的仅反映某一阶段的工作，有的则需要跨越多个阶段的工作。2022/11/12可行性研究与计划需求分析软件设计编码与单2022/11/1216

系统开发生命周期6总体设计7评审8详细设计5需求分析9评审4评审3可行性研究11切换运行12系统评价2系统调查1系统请求10编程调试系统设计系统分析系统定义系统运行系统实施

系统规划系统建设2022/11/1216系统开发生命周期678594312022/11/1217软件文档最终需要回答读者关心的下列问题：1.为什么要开发、维护或修改这个软件？(Why)2.工作目标要满足哪些需求？(What)3.需求应如何实现？(How)4.开发、维护或修改的工作应由谁来完成？(Who)5.开发工作的时间如何安排？(When)6.开发工作在什么环境中实现，所需信息从何而来？(Where)2022/11/1217软件文档最终需要回答读者关心的下列问2022/11/12为什么(Why)做什么(What)怎么做(How)谁来做(Who)何时做(When)何处做(Where)可行性研究报告√√项目开发计划√√√软件需求说明书√√数据要求说明书√√测试计划√√√概要设计说明书√详细设计说明书√数据库设计说明书√模块开发卷宗√用户手册√操作手册√测试分析报告√开发进度月报√√项目总结报告√维护和修改建议√√√√√182022/11/12为什么做什么怎么做谁来做何时做何处做可行2022/11/12讨论题191.你现在是否明确，为什么需要软件文挡？2.你能用自己的语言描述清楚什么是软件文挡，以及它的作用、地位和涉众吗？3.除了课堂上对软件文档的分类方法外，你还有更好、更合理的分类方法吗？如有，请尝试重新分类。2022/11/12讨论题191.你现在是否明确，为什么需要2022/11/12软件文档写作实训任课老师：冯茂岩

信息工程学院

2022/11/12软件文档写作实训任课老师：冯茂岩2022/11/1221参考资料参考资料

《软件编档导论》 清华大学出版社金波编著

《软件文档写作教程》

电子工业出版社马平等编著

计算机软件工程标准

(文档部分GB/T8567-1988、GB/T9385-1988) 国家标准汇编中国标准出版社2022/11/122参考资料参考资料2022/11/1222课程学时分配和评分标准课时分配：30学时考核标准：出勤（20%）+平时成绩（30%)+综合报告(50%)

＝总评（100%）2022/11/123课程学时分配和评分标准2022/11/1223了解软件文档在软件开发过程中的作用、地位以及文档编制的有关标准；理解软件文档与软件生存周期的关系，掌握软件文档的分类；熟悉软件文档的编写方法，了解常用的文档编制工具软件；能够根据标准模板编写可行性研究报告、需求分析说明书、概要设计文档、详细设计文档、用户文档和管理文档等；熟悉毕业论文的撰写和编排。教学目标2022/11/124了解软件文档在软件开发过程中的作用、地2022/11/12软件文档写作课程实践要求实践项目：若干模拟题目要求：每组不超过6人，设组长一名组长负责：组织、分工、安排进度等组长奖罚：引起过半数组员不满者，改选；带领全组顺利完成任务者，总评+5目的：通过课程实践，实际体验软件工程各阶段的主要工作；学会与他人合作，培养团队精神；培养软件文档的写作能力，为毕业设计及论文的撰写打下基础242022/11/12软件文档写作课程实践要求52022/11/1225实践内容(1)问题定义 （书面、电子）（选做）(2)可行性分析报告 （书面、电子）（必做）朱(3)项目开发计划 （书面、电子）（必做）韩(4)需求规格说明书 （书面、电子）（必做）曹晓雯(5)总体设计报告 （书面、电子）（必做）谢(6)系统测试计划 （书面、电子）（选做）(7)用户操作手册 （书面、电子）（必做）高帅(8)模拟毕业论文 （书面、电子）（必做）李要求：根据软件工程技术和项目管理理念，在组内合

理分工，协同工作。2022/11/126实践内容2022/11/1226问:什么是软件?软件=程序+文档2022/11/127问:什么是软件?软件=程序+文档2022/11/1227第一讲软件文档概念2022/11/128第一讲软件文档概念2022/11/1228

1.1为什么需要软件文档？

文档是计算机软件产品的重要组成部分，没有文档就不成其为软件，也更不能成为软件产品。软件文档是一种重要的软件工程技术资料。如系统分析文档、设计文档、版本说明文档……

软件文档的规范编制，在软件开发工作中占有突出的地位和相当大的工作量。高质量、高效率的编制、分发、管理、维护文档，及时的变更、修正、扩充和使用文档，对于软件产品的设计开发、发行使用、变更维护、转让移植、二次开发等，对于充分发挥软件产品的效益，都有着重要的意义。2022/11/1291.1为什么需要软件文档？2022/11/12291.2软件文档的定义

软件文档写作是为了记录目标系统的定义、规划、分析、研究、设计、开发、应用等各个阶段的设计思想和研究成果。

文档——某种数据媒体和其中所记录的数据。

文档具有永久性，并可供人或机器阅读，通常指专供人阅读的东西。文档作为计算机软件的重要组成部分，告诉用户如何操作和维护系统，提供关于未来改进和重新实施所需的信息，在开发人员、维护人员、管理人员、用户与计算机之间起着重要的桥梁作用。计算机软件用户桥梁作用2022/11/12101.2软件文档的定义计算机软件用2022/11/12301.3文档的作用

软件文档在产品开发过程中具有十分重要的桥梁作用，主要反映在以下几个方面：项目管理的依据

文档将通常“不可见的”软件开发进程转换成“可见的”文字资料，有利于项目的管理。技术交流的语言

项目小组内部、项目平行开发的各小组之间进行的交流和联系，通常都是通过文档来实现的。项目质量保证

文档是进行项目质量审查和评价的重要依据，有效文档的提供，可以满足项目质量保证人员和审查人员的工作需要。2022/11/12111.3文档的作用2022/11/1231支持培训与维护

合格的软件文档通常都提供有关软件运行、维护和培训的必要信息，支持软件产品的应用。支持软件维护

软件文档提供系统开发的全部必要技术资料，有利于维护人员熟悉系统，开展维护工作；软件维护文档记载了软件维护过程中软件及其环境变化的全部信息。记载软件历史

软件文档作为“记载软件历史的语言”，可用作未来项目的一种资源，向潜在用户报道软件的各种有利信息，便于他们判断自己是否需要该软件提供的服务。良好的系统文档，显然有助于完成软件的移植，或将软件转移到各种新的系统环境中去。2022/11/1212支持培训与维护2022/11/12321.4软件文档的分类

国家标准局在1988年1月颁布了《计算机软件开发规范》和《计算机软件产品开发文件编制指南》，作为软件开发和文档编制工作的准则和规程。基于软件生存期方法，可以从形式上将软件文档大致分成两类：软件开发过程中需要填写的各种图表，及应编制的各种技术文件或管理资料。软件文档根据其产生和使用的范围，主要划分为3大类：开发文档、用户文档和管理文档。软件文档开发文档用户文档管理文档可行性研究报告项目开发计划软件需求说明书数据库设计说明书概要设计说明书详细设计说明书用户手册操作手册软件需求说明书数据要求说明书项目开发计划模块开发卷宗开发进度月报测试计划测试分析报告项目开发总结报告2022/11/12131.4软件文档的分类软件文档开发文2022/11/12331.5软件文档与使用者的关系

软件开发中产生的各类文档面向不同的用户，而软件用户应该得到的文档也在商业合同中有明确规定。软件文档的使用对象开发人员维护人员管理人员用户可行性研究报告项目开发计划软件需求说明书数据要求说明书概要设计说明书详细设计说明书数据库设计说明书测试计划测试分析报告设计说明书测试分析报告模块开发卷宗可行性研究报告项目开发计划模块开发卷宗开发进度月报项目开发总结报告用户手册操作手册2022/11/12141.5软件文档与使用者的关系软件文2022/11/12可行性研究与计划需求分析软件设计编码与单元测试集成与测试运行与维护可行性研究报告√项目开发计划√√软件需求说明书√数据要求说明书√测试计划√√概要设计说明书√详细设计说明书√数据库设计说明书√模块开发卷宗√√用户手册√√√操作手册√√测试分析报告√开发进度月报√√√√√项目总结报告√维护和修改建议√341.6软件文档编制与软件生存期的关系

软件文档的编制是随着软件生存期各个阶段工作的开展而适时进行的。其中，有的仅反映某一阶段的工作，有的则需要跨越多个阶段的工作。2022/11/12可行性研究与计划需求分析软件设计编码与单2022/11/1235