【阐明编写手册的目的,指明读者对象。】数据库
【应包括项目的来源、委托单位、开发单位和主管部门。】工具
【列出手册中所用到的专门术语的定义和缩写词的原文。】性能
【列出有关资料的做者、标题、编号、发表日期、出版单位或资料来源,可包括:测试
a. 项目的计划任务书、合同或批文;spa
b. 项目开发计划;操作系统
c. 需求规格说明书;设计
d. 概要设计说明书;对象
e. 详细设计说明书;开发
f. 测试计划;编译
g. 手册中引用的其余资料、采用的软件工程标准或软件工程规范。】
a. 数据精确度【包括输入、输出及处理数据的精度。】
b. 时间特性【如响应时间、处理时间、数据传输时间等。】
c. 灵活性【在操做方式、运行环境需作某些变动时软件的适应能力。】
【列出软件系统运行时所需的硬件最小配置,如
a. 计算机型号、主存容量;
b. 外存储器、媒体、记录格式、设备型号及数量;
c. 输入、输出设备;
d. 数据传输设备及数据转换设备的型号及数量。】
【如:
a. 操做系统名称及版本号;
b. 语言编译系统或汇编系统的名称及版本号;
c. 数据库管理系统的名称及版本号;
d. 其余必要的支持软件。】
【给出程序的存储形式、操做命令、反馈信息及其含意、代表安装完成的测试实例以及安装所需的软件工具等。】
【给出输入数据或参数的要求。】
【说明数据来源、存储媒体、出现频度、限制和质量管理等。】
【如:
a. 长度;
b. 格式基准;
c. 标号;
d. 顺序;
e. 分隔符;
f. 词汇表;
g. 省略和重复;
h. 控制。】
【给出每项输出数据的说明。】
【说明输出数据的去向、使用频度、存放媒体及质量管理等。】
【详细阐明每一输出数据的格式,如:首部、主体和尾部的具体形式。】
【给出:
a. 出错信息及其含意;
b. 用户应采起的措施,如修改、恢复、再启动。】
【说明如何操做。】
【列出每种可能的运行状况,说明其运行目的。】
【按顺序说明每种运行的步骤,应包括:】
a. 运行目的;
b. 操做要求;
c. 启动方法;
d. 预计运行时间;
e. 操做命令格式及说明;
f. 其余事项。
【给出创建或更新文件的有关信息,如:】
a. 文件的名称及编号;
b. 记录媒体;
c. 存留的目录;
d. 文件的支配【说明肯定保留文件或废弃文件的准则,分发文件的对象,占用硬件的优先级及保密控制等。】
【提供应急或很是规操做的必要信息及操做步骤,如出错处理操做、向后备系统切换操做以及维护人员须知的操做和注意事项。】
【按字母顺序逐个列出所有操做命令的格式、功能及参数说明。】
【按文件名字母顺序或按功能与模块分类顺序逐个列出文件名称、标识符及说明。】