用户手册编写规范doc

《用户手册编写规范doc》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、案卷号日期＜项目名称＞用户手册作者：完成日期：签收人：签收日期：修改情况记录：版本号修改批准人修改人安装日期签收人用户手册编写规范目录1引言11.1编写目的11.2背景11.3定义11.4参考资料12用途12.1功能12.2性能22.2.1精度22.2.2时间特性22.2.3灵活性22.3安全保密23运行环境23.1硬设备23.2支持软件33.3数据结构34使用过程34.1安装与初始化34.2输入34.2.1输入数据的现实背景34.2.2输入格式44.2.3输入举例44.3输出54.3.1输出数据的现实背景54.3.2输出格式5

2、4.2.3输出举例54.4文卷查询54.5出错处理和恢复64.6终端操作6用户手册编写规范1引言1.1编写目的说明编写这份用户手册的目的，指出预期的读者范围。1.2背景说明：a．这份用户手册所描述的软件系统的名称；b．列出本项目的任务提出者、开发者、用户（或首批用户）以及安装该软件的单位。1.3定义列出本文件中用到的专门术语的定义和缩写词的原词组。1.4参考资料列出要用到的参考资料，如：a．本项目的经核准的计划任务书或合同、上级机关的批文；b．属于本项目的其他已发表的文件；c．本文件中各处引用的文件、资料，包括所要用到的软件开发

3、标准。列出这些文件的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。2用途2.1功能结合本软件的开发目的逐项地说明本软件所具有各项功能以及它们的极限范围。第6页用户手册编写规范2.2性能2.2.1精度逐项说明对各项输入数据的精度要求和本软件输出数据达到的精度，包括传输中的精度要求。2.2.2时间特性定量地说明本软件的时间特性，如响应时间，更新处理时间，数据传输、转换时间，计算时间等。2.2.3灵活性说明本软件所具有的灵活性，即当用户需求（如对操作方式、运行环境、结果精度、时间特性等的要求）有某些变化时，本软件

4、的适应能力。2.3安全保密说明本软件在安全、保密方面的设计考虑和实际达到的能力。3运行环境3.1硬设备列出为运行本软件所要求的硬设备的最小配置，如：a．处理机的型号、内存容量；b．所要求的外存储器、媒体、记录格式、设备的型号和台数、联机＼脱机；c．I＼O设备（联机＼脱机？）；d．数据传输设备和转换设备的型号、台数。第6页用户手册编写规范3.2支持软件说明为运行本软件所需要的支持软件，如：a．操作系统的名称、版本号；b．程序语言的编译＼汇编系统的名称和版本号；c．数据库管理系统的名称和版本号；d．其他支持软件。3.3数据结构列出为

5、支持本软件的运行所需要的数据库或数据文卷。4使用过程在本章，首先用图表的形式说明软件的功能同系统的输入源机构、输出接收机构之间的关系。4.1安装与初始化一步一步地说明为使用使用本软件而需进行的安装与初始化过程，包括程序的存储形式、安装与初始化过程中的全部操作命令、系统对这些命令的反应与答复、表征安装工作完成的测试实例等。如果有的话，还应说明安装过程中所需用到的专用软件。4.2输入规定输入数据和参量的准备要求。4.2.1输入数据的现实背景说明输入数据的现实背景，主要是：a．情况――例如人员变动、库存缺货；b．情况出现的频度――例如

6、是周期性的、随机的、一项操作状态的函数；第6页用户手册编写规范a．情况来源――例如人事部门、仓库管理部门；b．输入媒体――例如键盘、穿孔卡片、磁带；c．限制――出于安全、保密考虑而对访问这些输入数据所加的限制；d．质量管理――例如对输入数据合理性的检验以及当输入数据有错误时应采取的措施，如建立出错情况的记录等；e．支配――例如如何确定输入数据是保留还是废弃，是否要分配给其他的接受者等。4.2.2输入格式说明对初始输入数据和参量的格式要求，包括语法规则和有关约定，如：a．长度――例如字符数＼行，字符数＼项；b．格式基准――例如以左

7、面的边沿为基准；c．标号――例如标记或标识符；d．顺序――例如各个数据项的次序及位置；e．标点――例如用来表示行、数据组等的开始或结束而使用的空格、斜线、星号、字符组等；f．词汇表――给出允许使用的字符组合的列表，禁止使用的字符组合的列表等；g．省略和重复――给出用来表示输入元素可省略或重复的表示方式；h．控制――给出用来表示输入开始或结束的控制信息。4.2.3输入举例为每个完整的输入形式提供样本，包括：a．控制或首部――例如用来表示输入的种类和类型的信息，标识符输入日期，正文起点和对所用编码的规定；b．主体――输入数据的主体，

8、包括数据文卷的输入表述部分；c．尾部――用来表示输入结束的控制信息，累计字符总数等；d．省略――指出哪些输入数据是可省略的；e．重复――指出哪些输入数据是重复的。第6页用户手册编写规范4.3输出对每项输出作出说明。4.3.1输出数据的现实背景说明输出数据的现实背