软件文档写作01-概述

《软件文档写作01-概述》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、软件文档写作SoftwareDocumentComposition主讲：梁艳E-mail:liangyandxj@163.com教材教材：软件编档导论金波编著清华大学出版社参考资料：实用软件文档写作清华大学出版社肖刚等编著计算机软件工程标准(文档部分GB/T8567-1988、GB/T9385-1988)国家标准汇编中国标准出版社2课程目的通过本门课程的学习，了解软件文档在软件开发过程中的作用、地位以及文档编制的有关标准，熟悉软件文档的编写方法；了解各种文档编制规范，最终能够根据项目要求编写软件文档的能力，奠定工程化的软件开发基础。3课程内容和要求通过本课程的学习，使

2、学生理解软件文档在工程化的软件开发过程中的作用和意义；了解现有软件文档的标准体系；理解软件文档与软件生存周期的关系，掌握软件文档的分类；掌握软件文档编写的原则和步骤，能够根据标准模板编写简单需求分析说明书、概要设计文档、详细设计文档、用户文档和管理文档等。4课程特点(1)掌握基本内容——出发点；(2)培养学生的工程化思想；(3)以具体的实例，讲解软件文档在软件开发过程的重要地位和作用，培养学生学习兴趣；(4)以案例贯穿在授课内容之中，使用本附录中提供的案例；平时作业制定案例；课程设计分组指定案例；(5)注意互动，组织讨论，使学生主动参与到教学中来。5教学内容1.软件文档概

3、述（第1章）2.软件工程标准化（第2章）3.软件视图和文档风格（第3章相关）4.软件文档表达（第4章）5.软件编档的要求（第5章）6.软件开发文档（第6章）7.软件管理文档（第7章）9.软件用户文档（第8章）9.软件文档发行（第9章）10.软件编档管理（第10章）11.软件产品开发文档编制的国家标准及模版（附录A）12.软件文档实例分析6课程学时分配和评分标准课时分配：每周8节，共7周平时成绩：书面作业占25%实践性环节占50%考勤占25%考试方法：开卷（待定）评分标准：课程设计(60%)＋平时成绩(40%)＝总评100%（待定）7书面作业每一章的重点、难点查阅资料总结8

4、实践性环节作业《可行性研究报告》《项目开发计划》《软件需求说明书》《数据要求说明书》《概要设计说明书》《详细设计说明书》《数据库设计说明书》《用户手册》《操作手册》《模块开发卷宗》《测试计划》《测试分析报告》《开发进度月报》《开发总结报告》9软件文档写作课程设计项目HomeDesignandImprovementSystem课程设计项目是若干模拟情景题目要求：每组6人，设组长一名；组长负责：组织、分工、安排进度等；目的：通过课程设计，实际体验软件工程各阶段的主要工作，特别注意吸取教训；学会与他人合作，培养团队精神。10工作内容⑴《可行性研究报告》⑵《项目开发计划》⑶《软件

5、需求说明书》⑷《数据要求说明书》⑸《概要设计说明书》⑹《详细设计说明书》⑺《数据库设计说明书》⑻《用户手册》⑼《操作手册》⑽《模块开发卷宗》⑾《测试计划》⑿《测试分析报告》⒀《开发进度月报》⒁《开发总结报告》要求：根据软件工程技术和项目管理理念，在组内合理分工，协同工作。111.1为什么需要软件文档？（理解）1.2软件文档的定义（了解）1.3软件文档的作用（理解、重点）1.4软件文档的分类（掌握、重点）1.5软件文档与使用者的关系（掌握、重点）1.6软件文档编制与软件生存期的关系（理解、难点）第一章软件文档概念12第一章软件文档概念1.1为什么需要软件文档？文档是计算机软

6、件产品的重要组成部分，没有文档就不称其为软件，也更不能成为软件产品。软件文档是一种重要的软件工程技术资料。如系统分析文档、设计文档、版本说明文档……软件文档的规范编制，在软件开发工作中占有突出的地位和相当大的工作量。高质量、高效率的编制、分发、管理、维护文档，及时的变更、修正、扩充和使用文档，对于软件产品的设计开发、发行使用、变更维护、转让移植、二次开发等，对于充分发挥软件产品的效益，都有着重要的意义。观点：“如果不记下来，它就并不存在”。131.2软件文档的定义软件文档写作是为了记录目标系统的定义、规划、分析、研究、设计、开发、应用等各个阶段的设计思想和研究成果。文档—

7、—某种数据媒体和其中所记录的数据。文档具有永久性，并可供人或机器阅读，通常指专供人阅读的东西。文档作为计算机软件的重要组成部分，告诉用户如何操作和维护系统，提供关于未来改进和重新实施所需的信息，在开发人员、维护人员、管理人员、用户与计算机之间起着重要的桥梁作用。维护人员管理人员计算机软件用户桥梁作用开发人员141.3软件文档的作用软件文档在产品开发过程中具有十分重要的桥梁作用，主要反映在以下几个方面：1.项目管理的依据文档将通常“不可见的”软件开发进程转换成“可见的”文字资料，有利于项目的管理。2.技术交流的语言项目小组内部、