软件文档编写
第1章
软件工程标准化与软件文档
学习目标
软件生存周期与软件文档。
软件文档的作用与分类。
软件工程标准化的意义和作用。
软件工程标准的分类方法，软件工程标准的制定与推行过程。
我国的软件工程标准化工作和相关标准。
软件是指与计算机系统的操作有关的计算机程序及文档的集合。简单地说, 软件包括程序和文档两部分。计算机程序是指适合于计算机处理的指令序列以及所处理的数据：软件文档（software document）是与软件开发、维护和使用有关的文字材料, 如技术文档、设计文档、版本说明文档等，文档和程序共同构成了能完成特定功能的计算机软件。可以说，没有文档的软件，不能称其为软件，更不能成为软件产品。
1.1 软件生存周期与软件文档
软件生存周期由计划、开发和运行三个时期组成, 每一时期可再细分一些工作阶段。文档是与软件生存周期紧密关联的。
1. 计划时期
可以把计划时期再细分为几个阶段:
（1）问题定义
（2）可行性研究
（3）制订开发计划
2. 开发时期
（1）需求分析
确定系统的功能、性能和其他方面的要求: 系统必须做什么? 对所要解决的问题进 行详细定义, 这需要软件开发人员和用户共同讨论决定, 哪些需求是可以满足的, 并加以确切地描述。编写软件需求说明书、初步用户手册、确认测试计划和数据要求说明书等。
（2）概要设计
根据软件需求说明书的要求, 确定系统的事务处理流程, 确定软件的总体结构和全局数据结构, 并对输入和输出、安全性控制等方面做出全局性规划, 从而回答系统应该怎么做才能满足需求规格说明书的规定。编写软件概要设计说明书。
（3）详细设计
将整个系统分解成若干个子系统或模块, 定义子系统或模块间的接口关系, 对各子系统进行具体设计定义。编写软件详细设计说明书, 数据库或数据结构设计说明书, 组装测试计划。
（4）编码
把软件设计转换成计算机可以接受的程序, 即写成以某一程序设计语言表示的源程序清 单。
（5）测试和排错
设法找到程序的潜在错误, 并加以修正, 以提高软件的正确性和可靠性。
